StealIt

Writing Skills

writing-skills

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

Install

Run this in your project folder. It works with Claude Code, Cursor, Codex and dozens of other agents.

$ npx skills add obra/superpowers --skill writing-skills

Needs Node.js. Add -g to install for every project, or -a claude-code to skip the agent picker.

How to use Writing Skills

Once it's installed, Claude reads this skill on its own whenever a request matches what it's for, so you don't have to mention it by name. In Claude Code you can also run it directly by typing /writing-skills.

It includes scripts that Claude may run on your computer, so skim them on GitHub before you install.

What the instructions cover

  1. 1Overview
  2. 2What is a Skill?
  3. 3TDD Mapping for Skills
  4. 4When to Create a Skill
  5. 5Skill Types
  6. 6Directory Structure
  7. 7Writing SKILL.md
  8. 8Flowcharts
  9. 9Code Examples
  10. 10File Organization
  11. 11The Iron Law (Same as TDD)
  12. 12Testing All Skill Types

Section headings from the skill's SKILL.md file.

What's inside · 10 files

  • SKILL.md
  • references/CLAUDE_MD_TESTING.md
  • references/anthropic-best-practices.md
  • references/bulletproofing.md
  • references/discovery.md
  • references/flowcharts.md
  • references/graphviz-conventions.dot
  • references/persuasion-principles.md
  • references/testing-skills-with-subagents.md
  • render-graphs.js

More from Jesse Vincent

See all →

BrainstormingTop pick

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it…

Coding WorkflowJesse Vincent312k

Systematic DebuggingTop pick

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Coding WorkflowJesse Vincent312k

Diagnosing Superpowers

Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too…

Coding WorkflowJesse Vincent312k

Dispatching Parallel Agents

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

AI & AgentsJesse Vincent312k
See all →

Find SkillsTop pick

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending…

AI & AgentsVercel38k

Skill CreatorTop pick

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run…

AI & AgentsAnthropic187k

MCP BuilderTop pick

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers…

AI & AgentsAnthropic187k

Academy Guide

Stop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from…

AI & AgentsAnthropic187k