Skip to content
Download Longwave

Skill writing skill

Skill writing is part of Superpowers, Jesse Vincent's development method. Its job is to write and test new skills the way Superpowers does, test-first against subagents. It loads on its own when a request matches its description, and you can also call it by name. It bundles Node.js scripts that the instructions call for.

When the agent reaches for it

The agent keeps every installed skill's description in view and loads the full instructions when a request matches. This is the description it reads:

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

What the instructions cover

The sections of its SKILL.md, in order.

  • Overview
  • What is a Skill?
  • TDD Mapping for Skills
  • When to Create a Skill
  • Skill Types
  • Directory Structure
  • SKILL.md Structure
  • Skill Discovery Optimization (SDO)
  • Flowchart Usage
  • Code Examples
  • File Organization
  • The Iron Law (Same as TDD)
  • Testing All Skill Types
  • Common Rationalizations for Skipping Testing
  • Match the Form to the Failure
  • Bulletproofing Skills Against Rationalization
  • RED-GREEN-REFACTOR for Skills
  • Anti-Patterns
  • STOP: Before Moving to Next Skill
  • Skill Creation Checklist (TDD Adapted)
  • Discovery Workflow

What ships with it

Besides SKILL.md, the folder carries these. The agent opens them only when a step in the instructions calls for one.

  • examples/ 1 file · 5 KB
  • anthropic-best-practices.md 45 KB
  • graphviz-conventions.dot 6 KB
  • persuasion-principles.md 6 KB
  • render-graphs.js 5 KB
  • testing-skills-with-subagents.md 12 KB

Install the skill writing skill

In Claude Code, run this in a session. It comes from the publisher's own instructions.

Claude Code
/plugin install superpowers@claude-plugins-official

License: MIT.

In Longwave, add Superpowers from the marketplace. It installs all 14 of its skills, and your Claude Code, Codex and OpenCode threads can use them.

Questions people ask

How do I install the skill writing skill?

In Claude Code, run /plugin install superpowers@claude-plugins-official. In Longwave, add Superpowers from the marketplace, and its skills reach your Claude Code, Codex and OpenCode threads.

When does the agent use the skill writing skill?

When a request matches its description. The agent keeps only the name and description of each installed skill in view, and reads the full instructions when a task fits. You can also ask for it by name.

Use your skills in every harness.

Longwave installs a skill collection once, and your Claude Code, Codex and OpenCode threads can all use it.