> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill Mutator Protocol • AI Agent SDK

> SkillMutatorProtocol: Agent-managed skill CRUD operations.

# SkillMutatorProtocol

> Defined in the [**protocols**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocols.md) 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

> [card] [create()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-create.md)
>
> Create a new skill.

> [card] [patch()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-patch.md)
>
> Patch an existing skill using find-replace.

> [card] [edit()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-edit.md)
>
> Replace entire skill content.

> [card] [delete()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-delete.md)
>
> Delete a skill entirely.

> [card] [write\_file()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-write_file.md)
>
> Write a file within a skill directory.

> [card] [remove\_file()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-remove_file.md)
>
> Remove a file from a skill directory.

> [card] [list\_pending()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-list_pending.md)
>
> List all pending skill mutations awaiting approval.

> [card] [approve()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-approve.md)
>
> Approve a pending skill mutation.

> [card] [reject()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillMutatorProtocol-reject.md)
>
> Reject a pending skill mutation.

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/skills/protocols.py#L66)
>
> `praisonaiagents/skills/protocols.py` at line 66

***

## Related Documentation

> [card] [Models Overview](https://praison.ai/docs/docs/models)

> [card] [LLM Configuration](https://praison.ai/docs/docs/configuration/llm-config)

> [card] [Model Router](https://praison.ai/docs/docs/features/model-router)

> [card] [Model Failover](https://praison.ai/docs/docs/features/model-failover)

> [card] [Skills Concept](https://praison.ai/docs/docs/concepts/skills)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.