Individual skill

writing-skills

0upvotes

Use when creating new skills, editing existing skills, or verifying skills work before deployment

skills/productivity/writing-skills/SKILL.md

Read pinned source

Source commit 1c04afc2a760ed58cea1308851e7626f76c4ff44

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: No
Observed behavior: Not checked yet
Last checked: Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 27
Repository last updated: Oct 24, 2026
License: Apache-2.0

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

claude-code Repository topic
agent-skills Repository topic
agentic-workflow Repository topic
skill-md Repository topic
ai-agent Repository topic
ai-workflows Repository topic
codex Repository topic
coding-agent Repository topic
developer-tools Repository topic
gemini-cli Repository topic
writing Derived category
devops Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 26,360 bytes
SKILL.mdcore · 26,360 bytes
SKILL.mdcore · 26,360 bytes
anthropic-best-practices.mddoc · 45,825 bytes
examples/CLAUDE_MD_TESTING.mddoc · 5,423 bytes
graphviz-conventions.dotasset · 5,970 bytes
persuasion-principles.mddoc · 5,908 bytes
render-graphs.jsruns · 4,857 bytes
testing-skills-with-subagents.mddoc · 12,558 bytes

Read excerpt


# Writing Skills

## Overview

**Writing skills IS Test-Driven Development applied to process documentation.**

**Personal skills live in your runtime's skills directory** (`~/.claude/skills/` on Claude Code) — see [codex-tools.md](../using-superpowers/references/codex-tools.md) or [gemini-tools.md](../using-superpowers/references/gemini-tools.md) for the path on those runtimes. Codex, Copilot CLI, and Gemini CLI all also recognize `~/.agents/skills/` as a cross-runtime alias.

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.