Writing Claude Skills — Deep Research

Scope

Comprehensive research into how Claude Code skills work, best practices for authoring them, official guidance, community patterns, and gaps in existing documentation. Goal: produce a definitive skill for writing skills.

Phase Tracker

Phase	Status	Files
0	complete	README.md
1	complete	official-docs.md, community-patterns.md, existing-skills-analysis.md
2	complete	synthesis.md
3	complete	gap-fill-playbook.md, gap-fill-word-count.md
4/Skill	complete	../../writing-skills/SKILL.md

File Index

File	Lines	Topic	Phase
README.md	—	Coordination	0
official-docs.md	—	Anthropic official docs, SDK, blog posts	1
community-patterns.md	—	Community skills, GitHub repos, blog posts	1
existing-skills-analysis.md	—	Analysis of real skills in this repo + superpowers	1
synthesis.md	—	Cross-reference, gaps, heat map	2

Agent Guidance

• Write to files before returning
• Read existing work first
• One topic per agent
• Cap output at ~300 lines
• Summarize, don't transcribe
• Note gaps explicitly
• Use consistent structure
• Update this README when done