write-skills-demo
Use when creating new skills, editing existing skills, or verifying skills work before deployment
Best for skill authorsWorks with GitHubLow risk
⌘source
- author
@LeoYeAI- language
- Python
★2kstars
306forks
May 6, 2026
✦overview.md
Key Features
- ·TDD applied to process documentation
- ·RED-GREEN-REFACTOR cycle for skills
- ·Pressure scenarios with subagents
- ·Baseline behavior verification
- ·Loophole closing through refactoring
Use Cases
- →Creating a new skill from scratch with test cases
- →Editing an existing skill to improve clarity or coverage
- →Verifying a skill works before deployment to agents
- →Ensuring agents comply with documented behavior
Best for
- ✓skill authors
- ✓agent documentation teams
- ✓TDD practitioners
Not ideal for
- !one-off tasks
- !non-documentation work
- !projects without agent interaction
FAQs
name
writing-skills
description
Use when creating new skills, editing existing skills, or verifying skills work before deployment
Writing Skills
Overview
Writing skills IS Test-Driven Development applied to process documentation.
Personal skills live in agent-specific directories (~/.claude/skills for Claude Code, ~/.codex/skills for Codex)
You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).
Core principle: If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.
REQUIRED BACKGROUND: You MUST understand superpowers:test-driven-development before using this skill. That skill defines the fundamental RED-GREEN-REFACTOR cycle. This skill adapts TDD to documentation.
Official guidance: For Anthropic's official skill authoring best practices, see anthropic-best-practices.md. This document provides additional patterns and guidelines that complement the TDD-focused approach in this skill.
What is a Skill?
A skill is a reference guide for proven techniques, patterns, or tools. Skills help future Claude instances find and apply effective approaches.
$install
1-click copynpx skills add LeoYeAI/openclaw-master-skills --skill write-skills-demoSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.