📦

tool-design

Name: tool-design
Author: Asmayaseen

Revisão do conteúdo r1 Seguro 🌐 Acesso à rede⚙️ Comandos externos

Projete Ferramentas de Agente Confiáveis

Agentes falham quando nomes de ferramentas, entradas, saídas ou erros são ambíguos. Esta skill oferece padrões práticos para descrições de ferramentas, esquemas, formatos de resposta e testes.

Suporta: Claude Codex Code(CC)

🥈 81 Prata

Instalar com meu Agente

Copie esta solicitação para o seu Agente. Ela inclui a página canônica do Skill e o manifesto.

Solicitação do agente

Review the Skillstore skill "tool-design" from https://skillstore.io/skills/asmayaseen-tool-design.md and its manifest at https://skillstore.io/api/skills/asmayaseen-tool-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Seu Agente ainda deve apresentar o plano e solicitar qualquer confirmação exigida pela política de segurança.

Recursos legíveis por agentes

Use estes links quando um agente de IA, crawler ou script precisar de contexto limpo em vez de ler a página completa.

Detalhe em Markdown GET /skills/asmayaseen-tool-design.md manifest assinado GET /api/skills/asmayaseen-tool-design/manifest lockfile assinado GET /api/skills/asmayaseen-tool-design/lockfile

Testar

Usando "tool-design". Revisar uma ferramenta de busca de clientes com entradas vagas e erros genéricos.

Resultado esperado:

Uma declaração de propósito de ferramenta mais clara vinculada à busca de identidade do cliente.
Descrições específicas de parâmetros para ID do cliente ou email.
Orientação de erro acionável para casos de não encontrado e formato inválido.

Usando "tool-design". Avaliar cinco ferramentas de calendário que os agentes frequentemente confundem.

Resultado esperado:

Uma recomendação para consolidar etapas sequenciais de agendamento.
Alterações de nomenclatura que separam fluxos de trabalho de consulta, reserva e cancelamento.
Cenários de teste para precisão de seleção e recuperação de erros.

Auditoria de segurança

Seguro

v9 • 23/07/2026 Abrir o relatório versionado

All 20 static findings are false positives caused by ordinary prose, Markdown backticks, and inert Python examples. The skill contains no network calls, shell execution, system reconnaissance, prompt injection, or other malicious intent.

Arquivos analisados

714

Linhas analisadas

Itens de revisão

Falsos positivos ignorados

Fatores de risco

🌐 Acesso à rede (3)

references/best_practices.md:7 SKILL.md:8 SKILL.md:31

⚙️ Comandos externos (8)

SKILL.md:104 SKILL.md:106-113 SKILL.md:113-123 SKILL.md:123-151 SKILL.md:151-183 SKILL.md:183-204 SKILL.md:204-210 SKILL.md:210-214

A auditoria estática e semântica concluída mais recente não detectou achados de segurança confirmados. Isso não comprova que a skill não tenha efeitos colaterais.

Auditado por: codex Ver histórico de auditoria →

Compartilhar e citar este relatório

Compartilhe o relatório de avaliação versionado, o badge neutro, o cartão incorporável e as citações. A Skillstore apresenta evidências sem decidir se este Skill é seguro.

Abrir o relatório versionado

Copiar link do relatório

https://skillstore.io/skills/asmayaseen-tool-design/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Badge Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/asmayaseen-tool-design/security.svg)](https://skillstore.io/skills/asmayaseen-tool-design?utm_source=security_passport_badge)

Badge HTML

<a href="https://skillstore.io/skills/asmayaseen-tool-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/asmayaseen-tool-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Cartão incorporável

<iframe src="https://skillstore.io/embed/skills/asmayaseen-tool-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Citações acadêmicas (APA · BibTeX · CFF)

Citação APA

Asmayaseen. (2026). tool-design security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/asmayaseen-tool-design/audits/9

Citação BibTeX

@techreport{asmayaseen-asmayaseen-tool-design-2026,
  author = {Asmayaseen},
  title = {tool-design security audit report (audit version 9)},
  institution = {Skillstore},
  year = {2026},
  number = {9},
  url = {https://skillstore.io/skills/asmayaseen-tool-design/audits/9},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "tool-design security audit report (audit version 9)"
version: "unspecified"
type: report
authors:
  - name: "Asmayaseen"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/asmayaseen-tool-design/audits/9"
identifiers:
  - type: other
    value: "skillstore:asmayaseen-tool-design:audit:9"
    description: "Skillstore immutable audit report identifier"

Comparar variantes

4 variantes instaláveis

Cada autor permanece como um skill instalável separado. A variante recomendada é classificada pelas evidências do Skillstore.

Por que esta variante está em primeiro

Maior pontuação do Skillstore

Autor / fonte Pontuação do Skillstore Confiança das evidências Uso no Skillstore Atualizado

Asmayaseen Recomendado Atual

asmayaseen-tool-design

Pontuação do Skillstore 81

Confiança das evidências Alto

Uso no Skillstore 26

Atualizado

2026-09-09

muratcankoylan

muratcankoylan-tool-design

Pontuação do Skillstore 80

Confiança das evidências Alto

Uso no Skillstore 17

Atualizado

2026-09-09

ChakshuGautam

chakshugautam-tool-design

Pontuação do Skillstore 80

Confiança das evidências Alto

Uso no Skillstore 17

Atualizado

2026-09-09

sickn33

sickn33-tool-design

Pontuação do Skillstore 78

Confiança das evidências Alto

Uso no Skillstore 74

Atualizado

2026-09-09

Pontuação do Skillstore

Por que esta pontuação Confiança das evidências: Alto

Arquitetura

Manutenibilidade

Conteúdo

Comunidade

Conformidade com a especificação

O que você pode criar

Projetar uma Nova Ferramenta de Agente

Crie um contrato de ferramenta claro antes de expor um fluxo de trabalho a um agente de IA. Use a orientação para definir entradas, saídas, erros e gatilhos de uso.

Reduzir Erros de Seleção de Ferramentas

Revise um conjunto de ferramentas existente em busca de sobreposição, descrições vagas e nomenclatura inconsistente. Consolide fluxos de trabalho quando os agentes não conseguirem escolher de forma confiável.

Padronizar a Documentação de Ferramentas MCP

Aplique padrões consistentes de namespacing e descrição em ferramentas Model Context Protocol. Torne os nomes das ferramentas mais fáceis para os agentes referenciarem corretamente.

Teste estes prompts

Revisar Uma Ferramenta

Use a skill tool-design para revisar esta descrição de ferramenta. Identifique propósito pouco claro, entradas ausentes, saídas ausentes e orientação de erro fraca.

Melhorar um Contrato de Ferramenta

Use a skill tool-design para reescrever este contrato de ferramenta. Inclua quando usá-la, orientação de parâmetros, formato de retorno, erros e exemplos concisos.

Auditar um Conjunto de Ferramentas

Use a skill tool-design para avaliar este conjunto de ferramentas quanto a sobreposição, inconsistência de nomenclatura, ambiguidade de seleção e oportunidades para consolidar fluxos de trabalho.

Projetar um Plano de Testes

Use a skill tool-design para criar um plano de testes de agente para estas ferramentas. Inclua solicitações representativas, chamadas de ferramenta esperadas, modos de falha e etapas de refinamento.

Boas práticas

Descreva o que a ferramenta faz, quando usá-la, o que ela aceita e o que ela retorna.
Mantenha ferramentas sobrepostas separadas somente quando seus comportamentos ou contextos de uso forem claramente diferentes.
Escreva erros que expliquem o problema, o formato esperado e a próxima ação de recuperação.

Evitar

Usar nomes ou descrições vagos que forçam agentes a inferir o propósito da ferramenta.
Criar muitas ferramentas estreitas para etapas que os agentes deveriam concluir como um único fluxo de trabalho.
Retornar erros genéricos que não orientam nova tentativa, correção ou ação alternativa.