Writing Skills
TDD applied to process documentation: write test cases with subagents, watch them fail, write the skill, watch tests pass, and refactor.
Core Principle
If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.
What is a Skill?
A skill is a reference guide for proven techniques, patterns, or tools that help future Claude instances find and apply effective approaches.
Process
- Write test cases (pressure scenarios with subagents)
- Watch them fail (baseline behavior)
- Write the skill (documentation)
- Watch tests pass (agents comply)
- Refactor (close loopholes)
Required Background: Must understand TDD methodology first.
Personal skills live in agent-specific directories (~/.claude/skills for Claude Code).
Comments
No comments yet. Be the first to comment!
Related Tools
Writing Plans Skill
github.com/obra/superpowers
Create comprehensive implementation plans with bite-sized tasks assuming zero context, before touching code.
Using Superpowers Skill
github.com/obra/superpowers
Meta-skill that establishes how to find and use Skills - invoke relevant Skills before ANY response.
Test-Driven Development Skill
github.com/obra/superpowers
Write tests first, watch them fail, then write minimal code to pass - ensuring code quality through TDD methodology.
Related Insights
Skills + Hooks + Plugins: How Anthropic Redefined AI Coding Tool Extensibility
An in-depth analysis of Claude Code's trinity architecture of Skills, Hooks, and Plugins. Explore why this design is more advanced than GitHub Copilot and Cursor, and how it redefines AI coding tool extensibility through open standards.
Complete Guide to Claude Skills - 10 Essential Skills Explained
Deep dive into Claude Skills extension mechanism, detailed introduction to ten core skills and Obsidian integration to help you build an efficient AI workflow
Claude Code's Next Frontier: Not Code, But Your Local Obsidian Knowledge Base
Explore how Obsidian + Claude Code transforms from a knowledge management tool into your private AI assistant. Complete guide including obsidian-skills, Claudian plugin, Claudesidian template, and best practices for achieving both data privacy and AI capabilities.