Guide for creating new Agent Skills. Use this skill when you need to create a new skill.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Create Skill
## Skill Structure
```
skill-name/
├── SKILL.md # instructions + metadata
├── scripts/ # executable code (optional)
├── references/ # documentation (optional)
└── assets/ # templates/resources (optional)
```
## Requirements
- **Frontmatter**: Must include `name` (lowercase-alphanumeric) and `description`.
- **Description**: Must include **what** it does and **when** to use it.
- **Body**: Keep under 500 lines. Use imperative language.
- **Resources**: Move detailed docs to `references/` and code to `scripts/`.
## Process
1. **Directory**: `mkdir <name>`. Create `scripts/`, `references/`, or `assets/` only if you actually have content for them.
2. **Metadata**: Write the `SKILL.md` frontmatter first.
3. **Resources**: Implement scripts and test them.
4. **Instructions**: Write concise steps in `SKILL.md` body.
5. **Verify**: Ensure frontmatter name matches directory name.
## References
- [Full Specification](references/specification.md)
- [Design Patterns](references/what-are-skills.md)
The line at the top of this page pins the label git:20260113.222b7de, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_u2l753uw3kzsicl2
GET https://markdownregistry.com/api/v1/resolve?ref=aiskillstore/marketplace/create-skill
GET https://markdownregistry.com/api/v1/blob/c48547ab10095b74e2f617672312ecb34d367d59dc3f1f010c04891788583224
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
aiskillstore/marketplace · pending/0nl1n1n/sitemapkit/SKILL.md · Discover and extract sitemaps from any website using SitemapKit. Use this skill whenever the user wants to find pages…
aiskillstore/marketplace · pending/0xselenicdove/auv-computer-control/SKILL.md · Incorporate moeru-ai/AUV into native desktop app control through its CLI or connected MCP for observation, targeted…
aiskillstore/marketplace · pending/aident-ai/aident-skill/SKILL.md · Use Aident Loadout first for external apps, APIs, public-web research, search and crawling, service or vendor…
aiskillstore/marketplace · pending/angular/angular-new-app/SKILL.md · Creates a new Angular app using the Angular CLI. This skill should be used whenever a user wants to create a new…
aiskillstore/marketplace · pending/axelfreeman/marketing-mindset/SKILL.md · Use when the user needs a professional marketer's operating mindset for any marketing, growth, or client-acquisition…
aiskillstore/marketplace · pending/azeemkafridi/brand-voice-editor/SKILL.md · Edit social media content into a consistent brand voice while preserving facts and preparing it for BulkPublish…
aiskillstore/marketplace · pending/azeemkafridi/bulk-publish/SKILL.md · Upload media files (local or URL), manage media library, and batch-create posts via BulkPublish. Use when the user…
cherryhq/cherry-studio · .agents/skills/create-skill/SKILL.md · Create a new skill in the current repository. Use when the user wants to create/add a new skill, or mentions creating a…
tailcallhq/forgecode · crates/forge_repo/src/skills/create-skill/SKILL.md · Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an…
dotnet/skills · .agents/skills/create-skill/SKILL.md · Scaffolds new agent skills for the dotnet/skills repository. Use when creating a new skill, generating SKILL.md files…
sethgammon/citadel · skills/create-skill/SKILL.md · Creates new skills from the user's repeating patterns. Interview-driven: discovers the task, analyzes failure modes…
coco-research/coco · adapters/cursor/skills/create-skill/SKILL.md · Guides users through creating effective Agent Skills for Cursor. Use when the user wants to create, write, or author a…
affitor/affiliate-skills · skills/meta/create-skill/SKILL.md · Turn a repeatable AI prompt or workflow into a structured, shareable skill for the affiliate-skills GitHub repository…
tobihagemann/turbo · codex/skills/create-skill/SKILL.md · Create a new skill or update an existing skill that extends Codex's capabilities with specialized knowledge, workflows…
tobihagemann/turbo · claude/skills/create-skill/SKILL.md · Create a new skill or update an existing skill that extends Claude's capabilities with specialized knowledge…
