create-skill

Installation
Summary

Comprehensive guide for building modular skills that extend agent capabilities with specialized knowledge and workflows.

  • Skills are self-contained packages providing specialized workflows, tool integrations, domain expertise, and bundled resources for agents
  • SKILL.md must stay under 200 lines; use progressive disclosure by splitting detailed content into references/ files to reduce context load and activation time
  • Structure includes required YAML frontmatter (name, description) and markdown instructions, plus optional bundled resources (scripts, references, assets)
  • Follow core principles: be concise with every token, set appropriate degrees of freedom in instructions, and test across all target models
SKILL.md

Create Skill

Guide for creating effective skills that extend agent capabilities with specialized knowledge, workflows, and tool integrations.

About Skills

Skills are modular, self-contained packages that extend agent capabilities by providing specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific domains or tasks.

What Skills Provide

  1. Specialized workflows - Multi-step procedures for specific domains
  2. Tool integrations - Instructions for working with specific file formats or APIs
  3. Domain expertise - Company-specific knowledge, schemas, business logic
  4. Bundled resources - Scripts, references, and assets for complex and repetitive tasks

Progressive Disclosure Principle

The 200-line rule is critical. SKILL.md must be under 200 lines. If you need more, split content into references/ files.

Related skills

More from siviter-xyz/dot-agent

Installs
2.0K
GitHub Stars
16
First Seen
Jan 20, 2026