
Create Skill
Guide for authoring agent skills that stays within the 200-line rule through progressive disclosure.
- skills.sh installs
- 2.8K
- GitHub stars
- 22
- last updated
- Aug 21, 2026
What it does
- Covers skill anatomy: SKILL.md frontmatter, the three-level loading model, and optional
scripts/,references/, andassets/folders - Explains progressive disclosure, keeping SKILL.md under 200 lines and moving detail into
references/files - Provides concision and freedom-level guidance, including how much instruction to give for fragile versus flexible operations
- Designed for authors writing new skills or updating existing ones that extend agent capabilities
Install
$ npx -y skills add siviter-xyz/dot-agent --skill create-skill -yInstalls into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.
Files
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
- Specialized workflows - Multi-step procedures for specific domains
- Tool integrations - Instructions for working with specific file formats or APIs
- Domain expertise - Company-specific knowledge, schemas, business logic
- 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.
Three-Level Loading System
- Metadata (name + description) - Always in context (~100 words)
- SKILL.md body - When skill triggers (<200 lines, ideally <500 lines for optimal performance)
- Bundled resources - As needed by agent (unlimited)
Why Progressive Disclosure Matters
Details
- Repository
- github.com/siviter-xyz/dot-agent
- Categories
- Documentation, AI & Agent Building, Skill Development
More from siviter-xyz/dot-agent
All 3Similar to Create Skill
More Documentation
pulumi-best-practicespulumi/agent-skills2.7K installsLoad when the user is writing, reviewing, or debugging Pulumi TypeScript/Python programs; asks about Output<T> or apply() usage; wants to create ComponentResour
second-brain-ingestnicholasspisak/second-brain2.6K installsProcess raw source documents into wiki pages. Use when the user adds files to raw/ and wants them ingested, says "process this source", "ingest this article", "
usability-test-planowl-listener/designer-skills2.5K installsDesign a usability test plan with tasks, success metrics, participant criteria, and facilitation guide. Use when planning moderated or unmoderated usability tes
design-principlesowl-listener/designer-skills2.5K installsDefine a set of actionable design principles that guide decision-making and resolve trade-offs.
update-swiftui-apisavdlee/swiftui-agent-skill2.5K installsScan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements. Use when asked to "update latest APIs", "re
nuqspproenca/dot-skills2.4K installsnuqs (type-safe URL query state) best practices for Next.js and other React frameworks. This skill should be used when writing, reviewing, or refactoring code t