Pular para o conteúdo

Skill Writing Plans

Converta projeto aprovado em tarefas revisáveis com interfaces e verificação.

Comunidade · Jesse Vincent / Prime Radiant
AutorJesse Vincent / Prime Radiant
LicençaMIT
Fonteobra/superpowers · SKILL.md no GitHub
Site do projetoprimeradiant.com/superpowers
Funciona emClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lido na fonte em

writing-plans converte especificação aprovada em plano para engenheiro sem contexto anterior. Registra caminhos exatos, interfaces, restrições e comandos de verificação.

O plano é uma passagem de trabalho, não implementação pronta. Agrupa mudanças coerentes com entradas e saídas explícitas para coordenar construtores.

Do SKILL.md da skill: writing-plans

Esta é uma skill da comunidade, de Jesse Vincent / Prime Radiant, sem verificação nossa nem da Anthropic. Skills podem mandar o agente executar código, ler arquivos ou acessar a rede. Antes de instalar, leia o SKILL.md e todos os scripts da pasta, e procure qualquer coisa que não corresponda ao que ela diz fazer.

O que ela faz

  1. Leia a especificação aprovada e examine código relevante.
  2. Defina restrições globais, interfaces e tarefas revisáveis.
  3. Revise o plano e combine o modo de execução.

O que você recebe

  • Plano em docs/superpowers/plans/YYYY-MM-DD-<feature>.md com etapas e verificação.

Quando usar

  • Passar mudança de várias etapas para engenheiro que não leu a conversa.

Quando não usar

  • Requisitos ainda abertos: use brainstorming primeiro.

O que ela exige

  • Especificação aprovada, agente com arquivos e acesso ao projeto.
  • Execução, testes e commits precisam das ferramentas e permissões do projeto.

Arquivos da skill

Arquivo ou pastaPara que serve
SKILL.mdEstrutura, tamanho das tarefas e requisitos de passagem.

Licença conforme encontrada no repositório em 2026-11-19: MIT.

Prompts de exemplo

Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.

  • Converta este projeto aprovado em plano com interfaces e comandos de verificação.
  • Confira mudanças coerentes em vez de uma tarefa por arquivo.
  • Planeje a migração para um novo engenheiro e declare restrições globais.

Como instalar a skill writing-plans

Instalação e permissões

O plugin completo mantém links a brainstorming e execução. A pasta de planejamento só contém SKILL.md.

A fonte inclui passos de teste primeiro e commits. Adapte às regras do repositório; criar o plano não os executa.

Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:

Claude Code: pelo marketplace de plugins

  1. Abra o Claude Code em um terminal com claude.
  2. Este plugin está no marketplace oficial da Anthropic, que o Claude Code adiciona automaticamente na primeira vez que você o abre.
  3. Instale o plugin. O Claude Code mostra os detalhes primeiro: confira o que ele vai adicionar (skills, hooks, servidores MCP) e escolha se ele é para você, para todos neste repositório ou só para você neste repositório.
    /plugin install superpowers@claude-plugins-official
  4. Digite / e procure /superpowers:writing-plans, ou simplesmente peça a tarefa.

Pelo shell, em vez de dentro de uma sessão:

claude plugin install superpowers@claude-plugins-official

Claude Code: copie a pasta para a sua pasta de skills

Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).

git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/writing-plans ~/.claude/skills/

O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /writing-plans ou apenas descreva a tarefa.

No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.

Codex, Gemini CLI, Cursor e GitHub Copilot

Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:

git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/writing-plans .agents/skills/
AgentePasta do projetoSua pasta de usuárioObservações
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

Fontes destas instruções

Conferido com a documentação de cada fornecedor em 2026-11-14:

Plano que sobrevive a mudanças de contexto

Restrições globais cruzam tarefas; interfaces identificam o que cada etapa consome e produz e reduzem suposições ocultas.

Revise antes de executar. Comando detalhado ainda é proposta até rodar e ter resultado conferido.

Perguntas sobre a skill writing-plans

Executa o plano?

Não. Escreve, revisa e passa ao método de execução combinado.

Que contexto uma tarefa deve ter?

Caminhos exatos, interfaces, restrições, etapas e comandos concretos de verificação.

Cada arquivo vira uma tarefa?

Não. Tarefas são mudanças coerentes e revisáveis; limites de arquivo não bastam.

Precisa de serviço pago?

Não especifica serviço extra. Seu agente ou API ainda pode ter custo.

Mais skills de IA

Skills relacionadas

Categorias de skills