API Reference
Skill Tools API
Complete reference for the 5 skill management tools.
list_skills
List all skills with optional filters, or get a single skill by ID or name.
| Parameter | Type | Description |
|---|---|---|
| id | string | Get a specific skill by ID or name |
| domain | string | Filter by domain |
| status | string | draft, active, deprecated |
skill
Unified tool for creating, updating, and generating skills. The action parameter determines the operation.
action: "create"
Create a new skill (starts as draft).
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | "create" |
| 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 |
action: "update"
Update a skill's content or change its status (approve, reject, deprecate).
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | "update" |
| id | string | Yes | Skill ID |
| status | string | No | Set to "active" to approve, "rejected" to reject, "deprecated" to deprecate |
| 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 |
| review_notes | string | No | Notes for approval/rejection |
| reason | string | No | Reason for rejection/deprecation |
| successor_id | string | No | Replacement skill (for deprecation) |
action: "generate"
Auto-generate a skill from memory patterns.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | "generate" |
| memory_ids | string[] | No | Source memories |
| name | string | No | Suggested name |
| domain | string[] | No | Target domains |
| description | string | No | Suggested description |
| check_conflicts | boolean | No | Check for similar/conflicting skills |
skill_versions
View version history or rollback to a previous version.
| Parameter | Type | Required | Description |
|---|---|---|---|
| skill_id | string | Yes | Skill ID |
| rollback_to | number | No | Version number to restore (omit to view history) |
get_audit_log
View governance audit trail for skill lifecycle events.
| Parameter | Type | Description |
|---|---|---|
| skill_id | string | Filter by skill |
| limit | number | Max entries |
analyze_patterns
Detect recurring patterns in memories. Optionally check for skill conflicts.
| Parameter | Type | Description |
|---|---|---|
| domain | string | Filter by domain |
| days | number | Look-back period in days |
| limit | number | Max patterns to return |
| include_conflicts | boolean | Also detect skill conflicts |