Authoritative guide on how to architect, format, and structure new Anthropic Progressive Disclosure skills. Triggers: Use before creating OR modifying any `.agents/skills/**/*.md` files — Progressive Disclosure architecture (Map vs World Atlas), YAML frontmatter, skill structure. Complementary to `turn-memory-pre-flight` (load-runtime-effect dimension vs skill-shape dimension).
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
# Skill Creation Framework
If you are tasked with creating a new Agent Skill, you MUST immediately use the `view_file` tool to read and strictly adhere to `.agents/skills/create-skill/references/skill-authoring-guide.md` before creating any files. This prevents system prompt bloat and ensures future agents can parse your skill correctly.
**Source of Authority:** [ADR 0008: SKILL.md Anatomy and Authoring Contract](https://github.com/neomjs/neo/blob/dev/learn/agentos/decisions/0008-skill-anatomy-and-authoring-contract.md) — the graph-queryable canonical decision substrate for skill-shape (frontmatter contract, Map/Atlas split, manifest contract, anti-patterns). This skill's `references/skill-authoring-guide.md` is the procedural HOW-TO companion.
The line at the top of this page pins the label git:20260826.4960f06, 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_yx6lco6ygp5a2ick
GET https://markdownregistry.com/api/v1/resolve?ref=neomjs/neo-agent-skills/create-skill
GET https://markdownregistry.com/api/v1/blob/f810d30e6499ddfb00e5f9bf37b91b0fc2dcf2cca8710f754cb6ce0469882487
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.
neomjs/neo-agent-skills · .agents/skills/blocked-task-state/SKILL.md · Authoritative protocol for signaling blocked or input-required task states. Mandates targeted A2A pings using the…
neomjs/neo-agent-skills · .agents/skills/blog-post/SKILL.md · Authoring or revising a public-facing blog post (learn/blog/*.md + portal registration). Enforces hero-piece narrative…
neomjs/neo-agent-skills · .agents/skills/context-recovery/SKILL.md · Post-compaction recovery runbook for reconstructing active lane state from Memory Core recency, semantic recall…
neomjs/neo-agent-skills · .agents/skills/design-sweep/SKILL.md · The design sweep of one Fleet Manager view by a peer who did not build it, on the installed candidate, ending in a…
neomjs/neo-agent-skills · .agents/skills/epic-create/SKILL.md · Authoritative protocol for authoring an Epic body — the creation-side dual of `ticket-create` + entry partner of…
neomjs/neo-agent-skills · .agents/skills/epic-resolution/SKILL.md · Closeout protocol for parent epics — answers "we resolved all epic subs, are we done now?" with a structured matrix +…
neomjs/neo-agent-skills · .agents/skills/goal-scoping/SKILL.md · Scope a GOAL (release / initiative / major objective) into a few coherent owned LANES — the planning front-end of the…
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…
aiskillstore/marketplace · skills/0xmsc/create-skill/SKILL.md · Guide for creating new Agent Skills. Use this skill when you need to create a new skill.
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…
