Create Skill

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).

neomjs Updated

File contents

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 — 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.

neomjs/neo-agent-skills/tree/main/.agents/skills/create-skill commit 78870fd3e8

Frequently asked questions

npx skillmds@latest add neomjs/create-skill