Skill Tool Design
Projete contratos de ferramentas com entradas, saídas, critérios de escolha e erros recuperáveis claros.
Comunidade · Muratcan Koylan| Autor | Muratcan Koylan |
|---|---|
| Licença | MIT |
| Fonte | muratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md no GitHub |
| Funciona em | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lido na fonte em |
A skill tool-design melhora a interface entre um agente e suas ferramentas.
Cada ferramenta é um contrato: quando escolher, quais entradas aceita, o que retorna e como recuperar após falhar. Não implementa o backend.
Do SKILL.md da skill: ## Gotchas
O que ela faz
- Revisar nomes sobrepostos e descrições ambíguas.
- Definir parâmetros, respostas e recuperação de erros.
- Testar seleção e uso da ferramenta prevista.
O que você recebe
- Contratos, descrições revisadas e plano de validação.
Quando usar
- O agente escolhe ferramentas erradas ou repete argumentos inválidos.
Quando não usar
- Escolher toda a arquitetura ou unir operações sem relação em uma ferramenta excessiva.
O que ela exige
- Um agente com arquivos e esquemas, comportamento e falhas reais das ferramentas.
- O gerador Python usa modelos e notas heurísticas; não comprova melhoria na seleção real.
Arquivos da skill
| Arquivo ou pasta | Para que serve |
|---|---|
SKILL.md | Guia de contratos, exemplos e armadilhas de projeto. |
references/best_practices.md | Gerador Python de descrições e referências de projeto e consolidação. |
scripts/description_generator.py | Gerador Python de descrições e referências de projeto e consolidação. |
Licença conforme encontrada no repositório em 2026-11-20: MIT.
Prompts de exemplo
Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.
- Reescreva este contrato com padrões e erros recuperáveis explícitos.
- Revise estes nomes sobrepostos antes de propor consolidação.
- Projete respostas curtas e detalhadas para a mesma busca.
Como instalar a skill tool-design
Preservar referências e exemplos
Copie a pasta inteira. O plugin instala a coleção; use a pasta para instalar uma única skill.
Guia e modelos Python não exigem serviços externos. Testes reais precisam do seu agente e backend; upload hospedado e execução API não verificados aqui.
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. - Adicione o marketplace (uma vez por computador):
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering - 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 context-engineering@context-engineering-marketplace - Digite / e procure
/context-engineering:tool-design, ou simplesmente peça a tarefa.
Pelo shell, em vez de dentro de uma sessão:
claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplaceO plugin é instalado inteiro, então outras skills vêm junto, incluindo context-fundamentals, context-degradation, context-compression, context-optimization, self-managed-context, multi-agent-patterns, long-horizon-prompting, memory-systems, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states, latent-briefing, self-improvement-loops.
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/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p ~/.claude/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design ~/.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 /tool-design 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/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p .agents/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design .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:
Um contrato para a próxima ação
Nomes e descrições devem diferenciar alternativas reais. Especifique padrões, restrições de entrada e estrutura de saída.
Ofereça respostas curtas ou detalhadas conforme a tarefa. Erros devem permitir correções, em vez de repetidas tentativas cegas.
Validar a consolidação com tarefas reais
Menos ferramentas não garantem melhor desempenho. Compare sucesso, erros de argumentos e recuperação nas mesmas tarefas.
O gerador rascunha descrições; suas heurísticas não verificam backend, permissões ou compreensão do agente.
Perguntas sobre a skill tool-design
Cria um servidor MCP?
Não. Orienta o contrato; transporte, autenticação e execução do backend ainda precisam ser implementados.
Todas as ferramentas devem ser consolidadas?
Não. Una tarefas sobrepostas quando útil, separe operações distintas e teste a interface resultante.
O que uma resposta de erro deve conter?
O que falhou e qual entrada ou estado mudar antes de tentar novamente, sem expor detalhes sensíveis.
As notas do exemplo medem o desempenho do agente?
Não. Verificam padrões e metadados. Valide seleção e recuperação em execuções representativas.
Mais skills de IA
Skills relacionadas
Skill Dev-Browser
Comunidade · Sawyer HoodAutomatize o Chrome com páginas persistentes, scripts Puppeteer e um serviço local de linha de comando.Skill Agent Evaluation
Comunidade · Muratcan KoylanPlaneje regressões com verificações determinísticas, dimensões separadas e bases versionadas.Skill Context Degradation
Comunidade · Muratcan KoylanDiagnostique falhas em contextos longos e planeje a recuperação com fatos verificados e comparações por tarefa.Skill Advanced Evaluation
Comunidade · Muratcan KoylanProjete juízes LLM com rubricas baseadas em evidências, comparações invertidas e calibração humana.Skill Brainstorming
Comunidade · Jesse Vincent / Prime RadiantTransforme a ideia inicial em um projeto aprovado antes de implementar.Skill Writing Plans
Comunidade · Jesse Vincent / Prime RadiantConverta projeto aprovado em tarefas revisáveis com interfaces e verificação.