from skill_share63
Guidance for authoring and testing agent skills using a test-driven approach; helps design clear SKILL.md files and discovery-optimised descriptions.
Provides a comprehensive methodology for writing robust agent skills using Test-Driven Development (TDD) principles. It defines SKILL.md structure, discovery best practices (Claude Search Optimization), quality checklists, and testing strategies to ensure skills are findable and effective.
Use when creating new agent skills or revising existing SKILL.md files—especially if you want predictable agent behaviour, better discovery, and verified compliance under pressure scenarios. Ideal for authors preparing skills for production use.
Broadly applicable to skill authoring workflows for Claude Code, Codex-style agents, and other agent runtimes that load SKILL.md files and run inline examples or helper scripts.
A well-crafted skill that applies TDD principles to skill authoring. No scripts bundled — purely documentation. The SKILL.md is thorough with clear bad/good examples, a comprehensive checklist, and strong anti-rationalization patterns for discipline enforcement. CSO section is particularly valuable. Slightly verbose but content density is high.
Clean, high-quality documentation skill. No security concerns whatsoever. One of the better-structured skills I've audited. The CSO (Claude Search Optimization) section is a standout feature with practical, tested advice on description writing.
