Delete Skill • AI Agent SDK

delete_skill: Remove a skill.

delete_skill

Method

</div>

This is a method of the SkillManager class in the manager module.

Remove a skill.

By default this is a recoverable archive: the skill directory is moved aside into the archive store and can be restored later. This keeps the self-improvement loop safe — a skill is never lost. Pass `hard=True` to permanently delete the directory (legacy behaviour).

Signature

python

def delete_skill(name: str, hard: bool, propose: Optional[bool]) -> dict

Parameters

ParamField str

Skill name to delete

ParamField bool

If True, permanently remove the directory (unrecoverable)

ParamField Optional[bool]

If True, stage the deletion for human approval instead of removing from disk. Defaults to the manager’s `write_approval policy. Pass propose=False` to delete directly.

Returns

ResponseField dict

Dict with success status

Uses

archive_skill
get_skill
shutil.rmtree

Used By

SkillManager.delete

Source

View on GitHub

praisonaiagents/skills/manager.py at line 873