Skill · em Automatizar e estender

writing-skills

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

Procedência

Antes de instalar

7 arquivos · 105,1 KB · inclui 1 script que executa: render-graphs.js

Instalar na sua CLI

O comando baixa a versão fixada (commit 5bf4e78) direto da origem, para a pasta que a CLI lê. Precisa de curl (macOS e Linux); no Windows não há comando, porque o Rook Labs é para macOS.

Claude Code

Neste projeto: instala em .claude/skills/writing-skills/.

d=".claude/skills/writing-skills"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/writing-skills"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/anthropic-best-practices.md" "$u/anthropic-best-practices.md" \
  -o "$d/examples/CLAUDE_MD_TESTING.md" "$u/examples/CLAUDE_MD_TESTING.md" \
  -o "$d/graphviz-conventions.dot" "$u/graphviz-conventions.dot" \
  -o "$d/persuasion-principles.md" "$u/persuasion-principles.md" \
  -o "$d/render-graphs.js" "$u/render-graphs.js" \
  -o "$d/testing-skills-with-subagents.md" "$u/testing-skills-with-subagents.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Global: instala em ~/.claude/skills/writing-skills/.

d="$HOME/.claude/skills/writing-skills"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/writing-skills"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/anthropic-best-practices.md" "$u/anthropic-best-practices.md" \
  -o "$d/examples/CLAUDE_MD_TESTING.md" "$u/examples/CLAUDE_MD_TESTING.md" \
  -o "$d/graphviz-conventions.dot" "$u/graphviz-conventions.dot" \
  -o "$d/persuasion-principles.md" "$u/persuasion-principles.md" \
  -o "$d/render-graphs.js" "$u/render-graphs.js" \
  -o "$d/testing-skills-with-subagents.md" "$u/testing-skills-with-subagents.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Codex

Neste projeto: instala em .agents/skills/writing-skills/.

d=".agents/skills/writing-skills"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/writing-skills"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/anthropic-best-practices.md" "$u/anthropic-best-practices.md" \
  -o "$d/examples/CLAUDE_MD_TESTING.md" "$u/examples/CLAUDE_MD_TESTING.md" \
  -o "$d/graphviz-conventions.dot" "$u/graphviz-conventions.dot" \
  -o "$d/persuasion-principles.md" "$u/persuasion-principles.md" \
  -o "$d/render-graphs.js" "$u/render-graphs.js" \
  -o "$d/testing-skills-with-subagents.md" "$u/testing-skills-with-subagents.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Global: instala em ~/.agents/skills/writing-skills/.

d="$HOME/.agents/skills/writing-skills"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/writing-skills"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/anthropic-best-practices.md" "$u/anthropic-best-practices.md" \
  -o "$d/examples/CLAUDE_MD_TESTING.md" "$u/examples/CLAUDE_MD_TESTING.md" \
  -o "$d/graphviz-conventions.dot" "$u/graphviz-conventions.dot" \
  -o "$d/persuasion-principles.md" "$u/persuasion-principles.md" \
  -o "$d/render-graphs.js" "$u/render-graphs.js" \
  -o "$d/testing-skills-with-subagents.md" "$u/testing-skills-with-subagents.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Antigravity

Neste projeto: instala em .agents/skills/writing-skills/.

d=".agents/skills/writing-skills"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/writing-skills"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/anthropic-best-practices.md" "$u/anthropic-best-practices.md" \
  -o "$d/examples/CLAUDE_MD_TESTING.md" "$u/examples/CLAUDE_MD_TESTING.md" \
  -o "$d/graphviz-conventions.dot" "$u/graphviz-conventions.dot" \
  -o "$d/persuasion-principles.md" "$u/persuasion-principles.md" \
  -o "$d/render-graphs.js" "$u/render-graphs.js" \
  -o "$d/testing-skills-with-subagents.md" "$u/testing-skills-with-subagents.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Global: instala em ~/.gemini/antigravity-cli/skills/writing-skills/.

d="$HOME/.gemini/antigravity-cli/skills/writing-skills"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/writing-skills"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/anthropic-best-practices.md" "$u/anthropic-best-practices.md" \
  -o "$d/examples/CLAUDE_MD_TESTING.md" "$u/examples/CLAUDE_MD_TESTING.md" \
  -o "$d/graphviz-conventions.dot" "$u/graphviz-conventions.dot" \
  -o "$d/persuasion-principles.md" "$u/persuasion-principles.md" \
  -o "$d/render-graphs.js" "$u/render-graphs.js" \
  -o "$d/testing-skills-with-subagents.md" "$u/testing-skills-with-subagents.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Peça ao Rook

Já usa o Rook Labs? Cole no chat do Rook: instale a skill https://rooklabs.sh/marketplace/superpowers.writing-skills

Prévia do SKILL.md

---
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 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 recogn…

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 agents find and apply effective approaches.

**Skills are:** Reusable techniques, patterns, tools, reference guides

**Skills are NOT:** Narratives about how you solved a problem once

## TDD Mapping for Skills

| TDD Concept | Skill Creation |
|-------------|----------------|
| **Test case** | Pressure scenario with subagent |
| **Production code** | Skill document (SKILL.md) |
| **Test fails (RED)** | Agent violates rule without skill (baseline) |
| **Test passes (GREEN)** | Agent complies with skill present |
| **Refactor** | Close loopholes while maintaining compliance |
| **Write test first** | Run baseline scenario BEFORE writing skill |
| **Watch it fail** | Document exact rationalizations agent uses |
…

Ver todo o marketplace