Skill Mutator Protocol • AI Agent SDK

SkillMutatorProtocol: Agent-managed skill CRUD operations.

SkillMutatorProtocol

Defined in the protocols module.

AI Agent

Agent-managed skill CRUD operations.

Allows agents to create, edit, and manage their own skills at runtime. Implementations should provide safe-by-default behaviour: use `propose=True` (default) to stage mutations for human approval before writing to disk.

Methods

create()

Create a new skill.

patch()

Patch an existing skill using find-replace.

edit()

Replace entire skill content.

delete()

Delete a skill entirely.

write_file()

Write a file within a skill directory.

remove_file()

Remove a file from a skill directory.

list_pending()

List all pending skill mutations awaiting approval.

approve()

Approve a pending skill mutation.

reject()

Reject a pending skill mutation.

Source

View on GitHub

praisonaiagents/skills/protocols.py at line 66

Skill Mutator Protocol • AI Agent SDK