Create Skill
The create-skill guides developers and agents in building modular skills that extend agent capabilities with specialized knowledge, workflows, and tool integrations. It addresses the problem of maintaining performant, maintainable agent systems by establishing a progressive disclosure architecture that keeps initial context loads small (<200 lines) while enabling deeper resources to load on-demand. The skill emphasizes conciseness, appropriate degrees of freedom in instructions, and cross-model testing to ensure skills integrate effectively into agent systems.
- skills.sh installs
- 2.8K
- GitHub stars
- 22
- last updated
- Aug 21, 2026
Install
$ npx -y skills add siviter-xyz/dot-agent --skill create-skill --agent claude-codeInstalls into .claude/skills of the current project.
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
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/siviter-xyz/dot-agent
- Categories
- Documentation, AI & Agent Building, Skill Development
More from siviter-xyz/dot-agent
All 11Recommended
More Documentation
mojo-gpu-fundamentalsmodular/skillsThe basics of how to program GPUs using Mojo. Use this skill in addition to mojo-syntax when writing Mojo code that targets GPUs or other accelerators. Use targ2.8Kskills.sh installs
code-securitysemgrep/skillsSecurity guidelines for writing secure code. Use when writing code, reviewing code for vulnerabilities, or asking about secure coding practices like 'check for 2.8Kskills.sh installs
draft-offeranthropics/knowledge-work-pluginsDraft an offer letter with comp details and terms. Use when a candidate is ready for an offer, assembling a total comp package (base, equity, signing bonus), wr2.8Kskills.sh installs
android-native-devminimax-ai/skillsAndroid native application development and UI design guide. Covers Material Design 3, Kotlin/Compose development, project configuration, accessibility, and buil2.7Kskills.sh installs
competitor-analysiseronred/aso-skillsWhen the user wants to analyze competitors' App Store strategy, find keyword gaps, or understand competitive positioning. Also use when the user mentions "compe2.7Kskills.sh installs
dt-obs-awsdynatrace/dynatrace-for-aiAWS cloud resource monitoring including EC2, RDS, Lambda, ECS/EKS, VPC networking, load balancers, S3, DynamoDB, SQS/SNS, and cost optimization. Use when analyz2.7Kskills.sh installs