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).
61
72%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./.agents/skills/create-skill/SKILL.mdIf 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.
c1ce853
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.