스킬 tool-design

📦

tool-design

Name: tool-design
Author: muratcankoylan

콘텐츠 리비전 r2 안전 ⚡ 스크립트 포함⚙️ 외부 명령어🌐 네트워크 접근

Diseña herramientas de agentes que los modelos usen de forma fiable

Las herramientas de agentes fallan cuando las descripciones, los esquemas y los mensajes de error son ambiguos. Esta skill ofrece patrones prácticos para APIs de herramientas más claras, una consolidación más segura y mejores pruebas.

지원: Claude Codex Code(CC)

🥈 80 실버

Maintain this Skill? Claim it 🥈 80 실버

내 에이전트로 설치

이 요청을 에이전트에 복사하세요. 공식 Skill 페이지와 매니페스트가 포함되어 있습니다.

에이전트 요청

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

에이전트는 계속해서 계획을 표시하고 보안 정책에서 요구하는 확인을 요청해야 합니다.

에이전트가 읽기 쉬운 리소스

AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

Markdown 상세 GET /skills/muratcankoylan-tool-design.md 서명된 manifest GET /api/skills/muratcankoylan-tool-design/manifest 서명된 lockfile GET /api/skills/muratcankoylan-tool-design/lockfile

테스트해 보기

"tool-design" 사용 중입니다. Un agente de soporte tiene herramientas separadas para encontrar clientes, listar pedidos y emitir reembolsos.

예상 결과:

Combina la búsqueda de clientes y pedidos cuando sirvan a un único flujo de trabajo de soporte.
Mantén la autorización de reembolsos separada porque cambia el estado de la cuenta.
Documenta el traspaso desde los resultados de búsqueda hasta la revisión del reembolso.

"tool-design" 사용 중입니다. Una herramienta de búsqueda en base de datos devuelve registros grandes y errores genéricos.

예상 결과:

Añade modos de respuesta concisos y detallados para distintas necesidades de la tarea.
Sustituye los fallos genéricos por causas específicas y orientación para reintentar.
Incluye ejemplos de identificadores válidos y resultados esperados.

"tool-design" 사용 중입니다. Una integración MCP tiene nombres de herramientas ambiguos entre servidores.

예상 결과:

Usa nombres con ámbito de servidor en prompts y documentación.
Agrupa herramientas relacionadas bajo namespaces claros.
Añade ejemplos que muestren la herramienta prevista para cada flujo de trabajo.

보안 감사

안전

v8 • 2026. 8. 9. 버전별 보고서 열기

All 49 static findings are false positives from documentation markup, ordinary prose, or sandboxed command examples. The Python utility performs no network or process execution.

스캔된 파일

1,214

분석된 줄 수

검토 항목

오탐 무시됨

위험 요인

⚡ 스크립트 포함 (2)

references/architectural_reduction.md:48 references/architectural_reduction.md:124

⚙️ 외부 명령어 (35)

🌐 네트워크 접근 (3)

references/best_practices.md:7 SKILL.md:40 SKILL.md:93

가장 최근에 완료된 정적·의미론적 감사에서 확인된 보안 발견 사항이 감지되지 않았습니다. 이는 스킬에 부작용이 없음을 증명하지 않습니다.

감사자: codex 감사 이력 보기 →

이 보고서 공유 및 인용

버전이 지정된 평가 보고서, 중립 배지, 임베드 카드 및 인용을 공유하세요. Skillstore는 근거를 보고하지만 이 Skill의 안전 여부를 판단하지 않습니다.

버전별 보고서 열기

보고서 링크 복사

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

Markdown 배지

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

HTML 배지

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

임베드 카드

<iframe src="https://skillstore.io/embed/skills/muratcankoylan-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>

학술 인용 (APA · BibTeX · CFF)

APA 인용

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

BibTeX 인용

@techreport{muratcankoylan-muratcankoylan-tool-design-2026,
  author = {muratcankoylan},
  title = {tool-design security audit report (audit version 8)},
  institution = {Skillstore},
  year = {2026},
  number = {8},
  url = {https://skillstore.io/skills/muratcankoylan-tool-design/audits/8},
  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 8)"
version: "unspecified"
type: report
authors:
  - name: "muratcankoylan"
date-released: "2026-08-09"
url: "https://skillstore.io/skills/muratcankoylan-tool-design/audits/8"
identifiers:
  - type: other
    value: "skillstore:muratcankoylan-tool-design:audit:8"
    description: "Skillstore immutable audit report identifier"

변형 비교

설치 가능한 변형 4개

각 작성자의 스킬은 별도의 설치 항목으로 유지됩니다. 추천 변형은 Skillstore 근거로 순위가 정해집니다.

이 변형이 1위인 이유

Skillstore 점수가 가장 높음

작성자 / 소스 Skillstore 점수 증거 신뢰도 Skillstore 사용량 업데이트됨

Asmayaseen 권장

asmayaseen-tool-design

Skillstore 점수 81

증거 신뢰도 높음

Skillstore 사용량 31

업데이트됨

2026-10-25

muratcankoylan 현재

muratcankoylan-tool-design

Skillstore 점수 80

증거 신뢰도 높음

Skillstore 사용량 20

업데이트됨

2026-09-09

ChakshuGautam

chakshugautam-tool-design

Skillstore 점수 80

증거 신뢰도 높음

Skillstore 사용량 20

업데이트됨

2026-09-09

sickn33

sickn33-tool-design

Skillstore 점수 78

증거 신뢰도 높음

Skillstore 사용량 77

업데이트됨

2026-09-09

Skillstore 점수

이 점수의 이유 증거 신뢰도: 높음

아키텍처

유지보수성

콘텐츠

커뮤니티

사양 준수

만들 수 있는 것

Estandarizar APIs de herramientas de agentes

Define convenciones de nombres, parámetros y respuestas para un catálogo compartido de herramientas.

Reducir la confusión al seleccionar herramientas

Identifica herramientas superpuestas y consolida flujos de trabajo que causan errores de selección.

Mejorar la recuperación ante fallos de herramientas

Reescribe los errores para que los agentes sepan qué falló y cómo reintentarlo.

이 프롬프트를 사용해 보세요

Auditar una descripción de herramienta

Revisa esta descripción de herramienta en cuanto a claridad, entradas faltantes, respuestas y orientación sobre errores. Sugiere mejoras concisas: [pega la descripción de la herramienta].

Crear un contrato de herramienta

Diseña un contrato de herramienta para este flujo de trabajo. Incluye nombre, cuándo usarla, parámetros, forma de la respuesta y errores recuperables: [describe el flujo de trabajo].

Consolidar un conjunto de herramientas

Analiza estas herramientas para detectar superposición y ambigüedad de selección. Recomienda qué herramientas fusionar, mantener separadas o organizar con namespace: [pega la lista de herramientas].

Diseñar y probar un sistema de herramientas

Crea un plan de diseño de herramientas para este sistema de agentes. Incluye límites de herramientas, nomenclatura MCP, formatos de respuesta, recuperación ante errores, casos de prueba y riesgos de despliegue: [describe el sistema].

모범 사례

Documenta qué hace la herramienta, cuándo usarla, las entradas esperadas, los datos devueltos y los errores recuperables.
Consolida herramientas solo cuando admitan un flujo de trabajo claro y no oculten límites de seguridad importantes.
Prueba las descripciones con solicitudes representativas de agentes y revisa según los modos de fallo observados.

피하기

Usar nombres o descripciones vagas que obligan al agente a adivinar el propósito de la herramienta.
Fusionar herramientas no relacionadas solo para reducir el número de herramientas.
Devolver datos extensos por defecto cuando un formato conciso respondería a la tarea.

자주 묻는 질문

¿Quién debería usar esta skill?

Los desarrolladores, equipos de plataforma y equipos de producto de IA que diseñan herramientas para agentes pueden usarla.

¿Construye herramientas automáticamente?

No. Proporciona orientación de diseño y patrones auxiliares de ejemplo que un desarrollador puede adaptar.

¿Es compatible con herramientas MCP?

Sí. Explica el namespacing y los nombres de herramientas totalmente cualificados para integraciones de Model Context Protocol.

¿Puede reducir la proliferación de herramientas?

Sí. Ofrece criterios de consolidación para herramientas y flujos de trabajo superpuestos.

¿Qué debo vigilar en producción?

Trata los patrones de ejecución de comandos y acceso a archivos como capacidades privilegiadas que necesitan sandboxing, logging y controles de políticas.

¿Pueden usarla Claude, Codex y Claude Code?

Sí. El contenido de la skill es orientación general para flujos de trabajo de Claude, Codex y Claude Code.