API Reference
Skill Tools API
Complete reference for the 13 skill management tools.
list_skills
List all skills with optional filters.
| Parameter | Type | Description |
|---|---|---|
| domain | string | Filter by domain |
| status | string | draft, active, deprecated |
get_skill
Get a skill by ID or name.
| Parameter | Type | Description |
|---|---|---|
| id | string | Skill ID |
| name | string | Skill name |
search_skills
Semantic search over skills.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Search query |
| domain | string | No | Filter by domain |
| limit | number | No | Max results |
create_skill
Create a new skill (starts as draft).
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Skill name |
| description | string | Yes | What the skill covers |
| domain | string[] | Yes | Applicable domains |
| instructions | string | Yes | Skill content (markdown) |
| triggers | string[] | No | Activation phrases |
| templates | string[] | No | Code templates |
update_skill
Update an existing skill (creates new version).
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Skill ID |
| name | string | No | New name |
| description | string | No | New description |
| instructions | string | No | New instructions |
| triggers | string[] | No | New triggers |
| templates | string[] | No | New templates |
approve_skill
Activate a draft skill.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Skill ID |
| review_notes | string | No | Approval notes |
deprecate_skill
Mark a skill as deprecated.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Skill ID |
| reason | string | No | Why deprecated |
| successor_skill_id | string | No | Replacement skill |
reject_skill
Reject a draft skill.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Skill ID |
| reason | string | Yes | Rejection reason |
| review_notes | string | No | Additional notes |
get_skill_history
Get version history for a skill.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Skill ID |
rollback_skill
Revert to a previous version.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Skill ID |
| version | number | Yes | Version to restore |
find_similar_skills
Check for duplicate skills.
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Proposed name |
| domain | string[] | Yes | Target domains |
| triggers | string[] | No | Proposed triggers |
| description | string | No | Proposed description |
detect_conflicts
Find contradictory skills.
| Parameter | Type | Description |
|---|---|---|
| domain | string | Filter by domain |
| include_deprecated | boolean | Include deprecated skills |
get_audit_log
View governance history.
| Parameter | Type | Description |
|---|---|---|
| skill_id | string | Filter by skill |
| limit | number | Max entries |