Thinking Methods
Habilidades de pensamento estruturado para agentes de IA: brainstorming, suporte a decisões, pensamento sistêmico e estratégia. Feito para Claude Code e Cursor.
Documentação
Thinking Methods
Uma coleção curada de fluxos de trabalho cognitivos projetados para elevar seus agentes de IA de simples geradores de código a fortes colaboradores para suporte a decisões, brainstorming e pensamento estruturado. Compatível com Claude Code, Codex, Gemini CLI, Cursor, Antigravity, GitHub Copilot CLI, Factory Droid, Qwen Code, Grok Build, OpenCode, Pi, Kimi Code, Hermes Agent, Devin, Muse, Windsurf, OpenClaw e qualquer ferramenta que suporte a mesma especificação. Veja Instalação.
Visão geral
A maioria dos assistentes de codificação tende a dar respostas rápidas. Este repositório empacota métodos de pensamento estruturado como habilidades modulares SKILL.md do padrão aberto Agent Skills, para que um agente possa executar um método em uma decisão real em vez de improvisar um.
- Descreva o problema, não o método. A descrição de cada habilidade lista as situações e frases que ela atende ("o que pode dar errado?", "A ou B?", "por que isso continua acontecendo?") e quando ignorá-la. Você não precisa nomear o método.
- Não sabe qual usar? Comece com
thinking-method-selector. Ele escolhe um método para sua situação e o executa. - Cada habilidade é independente. Instale uma ou todas. Cada habilidade tem um caminho leve para perguntas pequenas e um exemplo prático na pasta
references/.
Instalação
Caminho mais rápido, funciona em mais de 70 agentes:
npx skills add ysskrishna/ai-agent-skills
Instalações nativas para agentes específicos:
Claude Code
/plugin marketplace add ysskrishna/ai-agent-skills
# All skills in one plugin
/plugin install ai-agent-skills@ai-agent-skills
Ou instale habilidades individuais como plugins separados:
/plugin install thinking-method-selector@ai-agent-skills
/plugin install five-whys@ai-agent-skills
/plugin install analytical-thinking@ai-agent-skills
/plugin install systems-thinking@ai-agent-skills
/plugin install first-principles-thinking@ai-agent-skills
/plugin install design-thinking@ai-agent-skills
/plugin install swot-analysis@ai-agent-skills
/plugin install tradeoff-analysis@ai-agent-skills
/plugin install prioritization@ai-agent-skills
/plugin install strategic-thinking@ai-agent-skills
/plugin install fermi-estimation@ai-agent-skills
/plugin install critical-thinking@ai-agent-skills
/plugin install pre-mortem@ai-agent-skills
/plugin install ethical-thinking@ai-agent-skills
/plugin install creative-thinking@ai-agent-skills
/plugin install lateral-thinking@ai-agent-skills
/plugin install six-thinking-hats@ai-agent-skills
Atualize com /plugin marketplace update ai-agent-skills. Remova com /plugin uninstall ai-agent-skills@ai-agent-skills. Verifique com /plugin.
Se a adição pelo marketplace falhar com Permission denied (publickey), execute git config --global url."https://github.com/".insteadOf git@github.com: uma vez. Mais em docs/claude-code-setup.md.
Codex CLI e App
codex plugin marketplace add ysskrishna/ai-agent-skills
codex plugin add ai-agent-skills@ai-agent-skills
Inicie uma nova sessão e descreva seu problema ou chame uma habilidade com @. Atualize com codex plugin marketplace upgrade ai-agent-skills. Remova com codex plugin remove ai-agent-skills@ai-agent-skills. Requer Codex CLI v0.122 ou posterior. Mais em docs/codex-setup.md.
Gemini CLI
# Extension: all skills in one install
gemini extensions install https://github.com/ysskrishna/ai-agent-skills
# Or only the skills, without the extension wrapper
gemini skills install https://github.com/ysskrishna/ai-agent-skills.git --path skills
Verifique com gemini skills list. Atualize com gemini extensions update ai-agent-skills. Remova com gemini extensions uninstall ai-agent-skills. A instalação da extensão usa o GitHub Release mais recente. Mais em docs/gemini-cli-setup.md.
Cursor
No Cursor, abra Customize, Plugins, Add, From GitHub Repository e insira github.com/ysskrishna/ai-agent-skills. No chat do Agent, você também pode executar /add-plugin.
Sem o caminho do plugin, instale as habilidades na pasta de habilidades do Cursor:
npx skills add ysskrishna/ai-agent-skills --agent cursor
Verifique em Customize, Skills. Mais em docs/cursor-setup.md.
Antigravity
agy plugin install https://github.com/ysskrishna/ai-agent-skills
Reinstale com o mesmo comando para atualizar. Remova com agy plugin uninstall ai-agent-skills. As habilidades são nomeadas como ai-agent-skills:<skill>. Mais em docs/antigravity-setup.md.
GitHub Copilot CLI
copilot plugin marketplace add ysskrishna/ai-agent-skills
copilot plugin install ai-agent-skills@ai-agent-skills
Verifique com copilot skill list. Atualize com copilot plugin update ai-agent-skills. Remova com copilot plugin uninstall ai-agent-skills. Você também pode instalar pelo GitHub CLI (veja GitHub CLI). Mais em docs/copilot-cli-setup.md.
Factory Droid
droid plugin marketplace add ysskrishna/ai-agent-skills
droid plugin install ai-agent-skills@ai-agent-skills --scope user
Instale o pacote ai-agent-skills. Os plugins de habilidade única não carregam habilidades no Droid. Atualize com droid plugin update ai-agent-skills@ai-agent-skills. Remova com droid plugin uninstall ai-agent-skills@ai-agent-skills. Mais em docs/droid-setup.md.
Qwen Code
qwen extensions install ysskrishna/ai-agent-skills:ai-agent-skills
As habilidades aparecem como ai-agent-skills:<skill>. A instalação usa o GitHub Release mais recente. Atualize com qwen extensions update ai-agent-skills. Remova com qwen extensions uninstall ai-agent-skills. Mais em docs/qwen-code-setup.md.
Grok Build
grok plugin install ysskrishna/ai-agent-skills --trust
Verifique com grok plugin list. Atualize com grok plugin update ai-agent-skills. Remova com grok plugin uninstall ai-agent-skills. Instale diretamente: o caminho do marketplace não funciona para este repositório. Mais em docs/grok-setup.md.
OpenCode
Adicione o plugin a opencode.json e reinicie o OpenCode (npm ou git):
{
"plugin": ["@ysskrishna/ai-agent-skills"]
}
{
"plugin": ["ai-agent-skills@git+https://github.com/ysskrishna/ai-agent-skills.git"]
}
OpenCode 2.0.4 ou posterior usa a chave plugins em vez de plugin. Ou instale globalmente: opencode plugin @ysskrishna/ai-agent-skills --global. Verifique pedindo ao agente para listar as habilidades. O OpenCode também lê .agents/skills, então npx skills add ysskrishna/ai-agent-skills funciona sem plugin. Mais em docs/opencode-setup.md.
Pi
pi install npm:@ysskrishna/ai-agent-skills
pi install git:github.com/ysskrishna/ai-agent-skills
Verifique com pi list. Atualize com pi update. Remova com pi remove npm:@ysskrishna/ai-agent-skills ou pi remove git:github.com/ysskrishna/ai-agent-skills. Mais em docs/pi-setup.md.
Kimi Code
Dentro do Kimi Code:
/plugins install https://github.com/ysskrishna/ai-agent-skills
Escolha Trust and install e execute /reload. Gerencie depois em /plugins. Mais em docs/kimi-setup.md.
Hermes Agent
Use um tap de habilidades. O Hermes então trata cada habilidade como uma habilidade normal:
hermes skills tap add ysskrishna/ai-agent-skills
hermes skills install ysskrishna/ai-agent-skills/five-whys
Repita a instalação para cada habilidade desejada. Atualize com hermes skills update. Remova com hermes skills uninstall five-whys.
Uma instalação por plugin também funciona (hermes plugins install ysskrishna/ai-agent-skills --enable), mas o Hermes não anuncia habilidades de plugin ao modelo, então use o tap. Mais em docs/hermes-setup.md.
Devin CLI
devin plugins install ysskrishna/ai-agent-skills
Verifique com devin plugins info ai-agent-skills. Comandos de plugin exigem login no Devin. Mais em docs/devin-setup.md.
Muse
git clone https://github.com/ysskrishna/ai-agent-skills.git
MUSE_EXPERIMENTAL_PLUGINS=1 muse plugins install ./ai-agent-skills --scope user
MUSE_EXPERIMENTAL_PLUGINS=1 muse plugins approve ai-agent-skills
Verifique com muse skills list --source plugin. Atualize com muse plugins update ai-agent-skills. Remova com muse plugins remove ai-agent-skills. Mais em docs/muse-setup.md.
OpenClaw (ClawHub)
Instale todas as habilidades em um único pacote do pacote ClawHub (plugin de pacote OpenClaw):
clawhub package download @ysskrishna/ai-agent-skills --output ./thinking-methods
Navegue com clawhub package inspect @ysskrishna/ai-agent-skills. Instalações por habilidade também ficam no ClawHub, por exemplo clawhub install critical-thinking (veja a tabela Skills). Sincronização do mantenedor: python3 scripts/publish_clawhub.py package plan e package publish após atualizar a versão do repositório; sincronização por habilidade usa plan / publish.
skills.sh (npx skills)
skills.sh instala habilidades na pasta própria de cada agente. Suporta Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Antigravity, OpenClaw, GitHub Copilot e muitos outros.
# Install all skills from this repo
npx skills add ysskrishna/ai-agent-skills
# List available skills
npx skills add ysskrishna/ai-agent-skills --list
# Or install individual skills (--skill names match plugin / directory names)
npx skills add ysskrishna/ai-agent-skills --skill thinking-method-selector
npx skills add ysskrishna/ai-agent-skills --skill five-whys
npx skills add ysskrishna/ai-agent-skills --skill analytical-thinking
npx skills add ysskrishna/ai-agent-skills --skill systems-thinking
npx skills add ysskrishna/ai-agent-skills --skill first-principles-thinking
npx skills add ysskrishna/ai-agent-skills --skill design-thinking
npx skills add ysskrishna/ai-agent-skills --skill swot-analysis
npx skills add ysskrishna/ai-agent-skills --skill tradeoff-analysis
npx skills add ysskrishna/ai-agent-skills --skill prioritization
npx skills add ysskrishna/ai-agent-skills --skill strategic-thinking
npx skills add ysskrishna/ai-agent-skills --skill fermi-estimation
npx skills add ysskrishna/ai-agent-skills --skill critical-thinking
npx skills add ysskrishna/ai-agent-skills --skill pre-mortem
npx skills add ysskrishna/ai-agent-skills --skill ethical-thinking
npx skills add ysskrishna/ai-agent-skills --skill creative-thinking
npx skills add ysskrishna/ai-agent-skills --skill lateral-thinking
npx skills add ysskrishna/ai-agent-skills --skill six-thinking-hats
GitHub CLI (gh skill)
Requer GitHub CLI v2.90.0 ou posterior.
# Browse this repo's skills interactively
gh skill install ysskrishna/ai-agent-skills
# Install specific skills directly
gh skill install ysskrishna/ai-agent-skills thinking-method-selector
gh skill install ysskrishna/ai-agent-skills five-whys
gh skill install ysskrishna/ai-agent-skills analytical-thinking
gh skill install ysskrishna/ai-agent-skills systems-thinking
gh skill install ysskrishna/ai-agent-skills first-principles-thinking
gh skill install ysskrishna/ai-agent-skills design-thinking
gh skill install ysskrishna/ai-agent-skills swot-analysis
gh skill install ysskrishna/ai-agent-skills tradeoff-analysis
gh skill install ysskrishna/ai-agent-skills prioritization
gh skill install ysskrishna/ai-agent-skills strategic-thinking
gh skill install ysskrishna/ai-agent-skills fermi-estimation
gh skill install ysskrishna/ai-agent-skills critical-thinking
gh skill install ysskrishna/ai-agent-skills pre-mortem
gh skill install ysskrishna/ai-agent-skills ethical-thinking
gh skill install ysskrishna/ai-agent-skills creative-thinking
gh skill install ysskrishna/ai-agent-skills lateral-thinking
gh skill install ysskrishna/ai-agent-skills six-thinking-hats
# Target a specific host and scope when needed
gh skill install ysskrishna/ai-agent-skills tradeoff-analysis --agent codex --scope user
gh skill instala no diretório de habilidades correto para o host selecionado, incluindo GitHub Copilot, Claude Code, Codex, Cursor, Gemini CLI e Factory Droid.
Habilidades disponíveis
Comece aqui
| Skill | Use quando | Registry |
|---|---|---|
thinking-method-selector | Você tem um problema ou decisão, mas nenhum método em mente. Escolhe um e o executa. |
Entenda um problema
| Skill | Use quando | Registry |
|---|---|---|
five-whys | Algo falhou ou continua recorrente e você precisa da causa real. | |
analytical-thinking | Um número mudou ou uma pergunta precisa de uma árvore de direcionamento, hipóteses e evidências. | |
systems-thinking | Uma mudança pode ter efeitos colaterais, ou um problema continua voltando entre equipes ou serviços. | |
first-principles-thinking | Você quer testar um padrão herdado ou uma abordagem copiada do zero. | |
design-thinking | Você precisa entender os usuários antes de projetar ou construir. |
Avalie e decida
| Skill | Use quando | Registry |
|---|---|---|
swot-analysis | Você quer avaliar onde uma equipe, produto ou empresa está e agir com base nisso. | |
tradeoff-analysis | Você precisa escolher entre opções concretas (A ou B, construir vs comprar). | |
prioritization | Há mais trabalho do que capacidade e você precisa de uma ordem e um limite de corte. | |
strategic-thinking | Você precisa escolher uma direção sob restrições. | |
fermi-estimation | Você precisa de um número aproximado rápido (capacidade, custo, tamanho). |
Verifique e reduza riscos
| Skill | Use quando | Registry |
|---|---|---|
critical-thinking | Você quer que uma afirmação, plano ou decisão seja verificado quanto a pontos fracos. | |
pre-mortem | Antes de um lançamento ou compromisso: imagine que falhou e descubra por quê. | |
ethical-thinking | Um plano pode prejudicar ou sobrecarregar injustamente pessoas. |
Gere ideias
| Skill | Use quando | Registry |
|---|---|---|
creative-thinking | Você quer muitas opções novas antes de escolher. | |
lateral-thinking | As ideias parecem travadas ou incrementais e você precisa de um ângulo diferente. |
Veja por vários ângulos
| Skill | Use quando | Registry |
|---|---|---|
six-thinking-hats | Você quer fatos, sentimentos, riscos, benefícios e novas ideias examinados separadamente. |
O texto de gatilho completo para cada skill está no frontmatter SKILL.md.
Uso
Descreva sua situação e o agente escolhe uma skill correspondente a partir das descrições, ou nomeie uma skill diretamente.
We have to pick a job queue: Postgres, Redis or a managed service. Team of four.
What could go wrong with the database cutover next Friday?
Why did last night's deploy fail? Keep asking why until we reach something we can fix.
I have a pile of problems and no idea how to approach them.
Para chamar uma skill pelo nome, use /skill-name após uma instalação skills.sh ou gh skill (por exemplo, /pre-mortem). A instalação do plugin Claude Code cria namespaces para skills pelo nome do plugin (/<plugin>:<skill>).
Construído e mantido por
Thinking Methods é construído e mantido por:
| Nome | GitHub | Papel | |
|---|---|---|---|
![]() | Y. Siva Sai Krishna | @ysskrishna | Criador |
Changelog
Consulte CHANGELOG para o histórico de versões.
Suporte
Se você achar esta biblioteca útil:
- ⭐ Dê uma estrela no repositório
- 🐛 Reporte problemas
- 🔀 Envie pull requests
- 💝 Patrocine no GitHub
Licença
MIT © Y. Siva Sai Krishna — consulte LICENSE para detalhes.
GitHub do autor • LinkedIn do autor • Site do autor • ClawHub • Reportar problemas
