skills-authoring

What problem does it solve?

Creates or updates skills with proper YAML frontmatter, progressive disclosure, and best practices per the open Agent Skills specification. Supports simple, tool-restricted, multi-file, and script-based skills. Use when creating new skills, authoring skills, extending agent capabilities, or when --create-skill or --new-skill flag is mentioned.

Core Features & Use Cases

• Templates supported: from templates/:
  • simple-skill.md - Single SKILL.md file
  • tool-restricted-skill.md - Limited tool access
  • multi-file-skill.md - With supporting files
  • script-based-skill.md - Includes executable scripts
• Name pattern: kebab-case and must match directory
• Frontmatter validation: name, description, and optional fields
• Supporting files: Add references/, scripts/, or assets/ when needed
• Progressive disclosure: keep SKILL.md lean; move details to supporting files
• Validation aids: ensures compatibility with Agent Skills specification

Quick Start

1. Pick a template from templates/ (e.g., simple-skill.md).
2. Generate the skill directory name (lowercase, hyphens only) and ensure it matches name in frontmatter.
3. Write SKILL.md with frontmatter and instructions.
4. Optionally add references/, scripts/, or assets/ to extend capabilities.