save_skill
Create or update a skill with automatic validation and backup. Ensures descriptions meet length and clarity requirements, and body instructions are actionable.
Instructions
Create or update a skill. Validates before saving, auto-backs up before overwrite.
This tool enforces quality gates — if the skill fails validation, it will be REJECTED with specific error messages explaining what to fix. Fix the issues and call save_skill again.
Validation checks:
Description must be >= 50 chars and explain WHAT + WHEN
Body must be 3-500 lines of actionable instructions
Description should include trigger conditions
Body should avoid overly rigid language (explain WHY instead)
Args: name: Skill identifier (lowercase, hyphens, max 64 chars). description: What the skill does and when to trigger (>= 50 chars). Front-load the key use case. Include trigger conditions like 'Use this skill when...' or 'Activate whenever...'. body: Markdown body (3-500 lines). Follow the skill writing guide. extra_frontmatter: Optional JSON of additional frontmatter fields.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| description | Yes | ||
| body | Yes | ||
| extra_frontmatter | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |