Skill Writing Plans
Converta projeto aprovado em tarefas revisáveis com interfaces e verificação.
Comunidade · Jesse Vincent / Prime Radiant| Autor | Jesse Vincent / Prime Radiant |
|---|---|
| Licença | MIT |
| Fonte | obra/superpowers · SKILL.md no GitHub |
| Site do projeto | primeradiant.com/superpowers |
| Funciona em | Claude 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
O que ela faz
- Leia a especificação aprovada e examine código relevante.
- Defina restrições globais, interfaces e tarefas revisáveis.
- 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 pasta | Para que serve |
|---|---|
SKILL.md | Estrutura, 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
- Abra o Claude Code em um terminal com
claude. - Este plugin está no marketplace oficial da Anthropic, que o Claude Code adiciona automaticamente na primeira vez que você o abre.
- 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 - 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-officialClaude 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/| Agente | Pasta do projeto | Sua pasta de usuário | Observaçõ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). |
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
Skill Brainstorming
Comunidade · Jesse Vincent / Prime RadiantTransforme a ideia inicial em um projeto aprovado antes de implementar.Skill Subagent-Driven Development
Comunidade · Jesse Vincent / Prime RadiantExecute plano aprovado com novos implementadores, revisões focadas e registro das tarefas.planning-with-files skill
Comunidade · OthmanAdiMantenha planos e progresso em arquivos com hooks conforme o agente.Skill To-Spec
Comunidade · Matt PocockRegistre decisões acordadas como especificação e publique no rastreador configurado.Skill To-Tickets
Comunidade · Matt PocockDivida especificação em fatias verticais demonstráveis com bloqueios explícitos.Hospedagem própria do n8n skill
Comunidade · Romuald CzłonkowskiImplante e mantenha n8n em Docker com HTTPS Caddy, serviços privados e backups verificados.