Writing Skills
This is TDD for documentation. You write pressure scenarios with subagents, watch them fail without the skill, write the documentation, then verify agents actually comply. The core insight is that if you didn't see an agent violate the rule first, you don't know if your skill teaches anything useful. It maps the full RED-GREEN-REFACTOR cycle to skill creation: baseline behavior is your failing test, the skill document is production code, and you refactor by finding new loopholes agents exploit. Includes practical guidance on frontmatter structure, when descriptions should trigger discovery versus when they accidentally replace the content, and why mechanical constraints belong in validation not documentation.
- skills.sh installs
- 245
- GitHub stars
- 150
- last updated
- Aug 21, 2026
Install
$ npx -y skills add unclecatvn/agent-skills --skill writing-skills --agent claude-codeInstalls into .claude/skills of the current project.
Files
This is TDD for documentation. You write pressure scenarios with subagents, watch them fail without the skill, write the documentation, then verify agents actually comply. The core insight is that if you didn't see an agent violate the rule first, you don't know if your skill teaches anything useful. It maps the full RED-GREEN-REFACTOR cycle to skill creation: baseline behavior is your failing test, the skill document is production code, and you refactor by finding new loopholes agents exploit. Includes practical guidance on frontmatter structure, when descriptions should trigger discovery versus when they accidentally replace the content, and why mechanical constraints belong in validation not documentation.
Browse the repository on GitHubSponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/unclecatvn/agent-skills
- Categories
- Documentation, AI & Agent Building, Skill Development
- First seen
- Jun 3, 2026
More from unclecatvn/agent-skills
All 9Recommended
More Documentation
book-writing-workspaceaktsmm/agent-skillsOperate a reusable technical book manuscript workspace with writing structure, reader persona SSOT, review rules, and optional Markdown to Re:VIEW/PDF support. 239skills.sh installs
umap-learndavila7/claude-code-templatesUMAP dimensionality reduction. Fast nonlinear manifold learning for 2D/3D visualization, clustering preprocessing (HDBSCAN), supervised/parametric UMAP, for hig222skills.sh installs
readme-generatordmccreary/claude-skillsCreates or updates the GitHub README for a textbook project with badges, project overview, site metrics, and getting-started instructions.213skills.sh installs
demo-produceryonatangross/orchestkitUniversal demo video creator for skills, agents, plugins, tutorials, CLI commands, and code walkthroughs. Generates scripts, storyboards, VHS terminal recording195skills.sh installs
llm-fine-tuning-guideqodex-ai/ai-agent-skillsMaster fine-tuning of large language models for specific domains and tasks. Covers data preparation, training techniques, optimization strategies, and evaluatio194skills.sh installs