Skill Tool Design
Diseña contratos de herramientas con entradas, salidas, criterios de selección y errores recuperables claros.
Comunidad · Muratcan Koylan| Autor | Muratcan Koylan |
|---|---|
| Licencia | MIT |
| Fuente | muratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md en GitHub |
| Funciona en | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Leída en la fuente el |
El skill tool-design mejora la interfaz entre un agente y sus herramientas.
Define cada herramienta como un contrato: cuándo elegirla, qué entradas admite, qué devuelve y cómo recuperarse de un fallo. No implementa el backend.
Del SKILL.md de la skill: ## Gotchas
Qué hace
- Revisar nombres solapados y descripciones ambiguas.
- Definir parámetros, formatos de respuesta y recuperación de errores.
- Probar la selección y el uso de la herramienta prevista.
Qué obtienes
- Contratos, descripciones revisadas y un plan de validación.
Cuándo usarla
- El agente elige herramientas incorrectas o envía argumentos inválidos repetidamente.
Cuándo no usarla
- Elegir toda la arquitectura o fusionar operaciones ajenas en una herramienta excesiva.
Qué necesita
- Un agente con archivos y los esquemas, comportamientos y fallos reales de las herramientas.
- El generador Python usa plantillas y puntuaciones heurísticas; no demuestra mejoras de selección reales.
Archivos de la skill
| Archivo o carpeta | Para qué sirve |
|---|---|
SKILL.md | Guía de contratos, ejemplos y errores de diseño. |
references/best_practices.md | Generador Python de descripciones y referencias de diseño y consolidación. |
scripts/description_generator.py | Generador Python de descripciones y referencias de diseño y consolidación. |
Licencia según el repositorio el 2026-11-20: MIT.
Prompts de ejemplo
Escribe uno de estos después de instalarla; si nombras la skill, te aseguras de que se use.
- Reescribe este contrato con valores predeterminados y errores recuperables explícitos.
- Revisa estos nombres solapados antes de proponer una consolidación.
- Diseña respuestas breves y detalladas para una misma búsqueda.
Cómo instalar tool-design
Conservar referencias y ejemplos
Copia toda la carpeta. El plugin instala la colección; para una sola herramienta de instrucciones, instala únicamente la carpeta del skill.
La guía y las plantillas Python no necesitan servicios externos. Las pruebas reales requieren tu agente y backend; no se han verificado la carga alojada ni la ejecución API.
Una skill es una carpeta con un archivo SKILL.md. La instalas una vez; el agente lee su breve descripción al empezar cada sesión y carga las instrucciones completas solo cuando una petición encaja. Elige dónde la usas:
Claude Code: desde el marketplace de plugins
- Abre Claude Code en una terminal con
claude. - Añade el marketplace (una vez por ordenador):
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering - Instala el plugin. Claude Code muestra antes sus detalles: comprueba qué va a añadir (skills, hooks, servidores MCP) y elige si es para ti, para todos en este repositorio o solo para ti en este repositorio.
/plugin install context-engineering@context-engineering-marketplace - Escribe / y busca
/context-engineering:tool-design, o simplemente pide la tarea.
Desde tu shell en lugar de una sesión:
claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplaceEl plugin se instala completo, así que vienen otras skills con él, entre ellas 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: copia la carpeta en tu carpeta de skills
Pon la carpeta de la skill en ~/.claude/skills/ para usarla en todos los proyectos de este ordenador, o en .claude/skills/ dentro de un repositorio para compartirla con todos los que trabajan en él (haz 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/Claude Code detecta las skills nuevas o modificadas en estas carpetas durante la sesión. Si la carpeta de skills no existía al empezar la sesión, ejecuta /reload-skills una vez. Después escribe /tool-design o simplemente describe la tarea.
En Windows, ejecuta los comandos en Git Bash o WSL, o copia la carpeta al mismo sitio con el Explorador de archivos.
Codex, Gemini CLI, Cursor y GitHub Copilot
Estos agentes leen las mismas carpetas SKILL.md. La única carpeta que aceptan los cuatro dentro de un proyecto es .agents/skills/, así que esto copia la skill ahí:
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 | Carpeta del proyecto | Tu carpeta de usuario | Notas |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Escribe $ o ejecuta /skills para elegir una skill; Codex también elige una cuando tu tarea encaja. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | O instálala desde Git con gemini skills install <git URL> --path <folder> --consent. El 18 de junio de 2026, Google sustituyó Gemini CLI por Antigravity CLI para los usuarios del nivel gratuito y de Google One; Antigravity usa .agents/skills/ en un proyecto y ~/.gemini/config/skills/ para ti. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Escribe / en el chat de Agent para elegir una skill. Cursor también lee las carpetas .claude/skills/ de Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funciona en Copilot CLI, en el agente en la nube y en el modo agente de VS Code, Visual Studio y JetBrains (la compatibilidad con cada IDE depende de la versión). O ejecuta gh skill install OWNER/REPOSITORY SKILL (vista previa pública, GitHub CLI 2.90.0 o posterior). |
Fuentes de estos pasos
Comprobado con la documentación de cada proveedor el 2026-11-14:
Un contrato que permite actuar
Los nombres y descripciones deben distinguir alternativas reales. Explicita valores predeterminados, restricciones y estructura de salida.
Ofrece respuestas breves o detalladas según la tarea. Los errores deben permitir corregir algo, en lugar de provocar reintentos ciegos.
Validar la consolidación con tareas reales
Reducir herramientas es una opción, no una garantía de rendimiento. Compara éxito, argumentos erróneos y recuperación en las mismas tareas.
El generador redacta descripciones; sus heurísticas no verifican el backend, los permisos ni la comprensión del agente.
Preguntas sobre tool-design
¿Construye un servidor MCP?
No. Orienta el contrato; transporte, autenticación y ejecución del backend deben implementarse aparte.
¿Conviene consolidar todas las herramientas?
No. Agrupa tareas solapadas cuando convenga, separa operaciones distintas y prueba la interfaz resultante.
¿Qué debe contener una respuesta de error?
Qué falló y qué entrada o estado debe cambiar antes de reintentar, sin revelar detalles sensibles.
¿Las puntuaciones del ejemplo miden el rendimiento del agente?
No. Comprueban patrones y metadatos. Valida selección y recuperación con ejecuciones representativas.
Más skills de IA
Skills relacionadas
Skill Dev-Browser
Comunidad · Sawyer HoodAutomatiza Chrome con páginas persistentes, scripts Puppeteer y un servicio local de línea de comandos.Skill Agent Evaluation
Comunidad · Muratcan KoylanPlanifica regresiones con comprobaciones deterministas, dimensiones independientes y referencias versionadas.Skill Context Degradation
Comunidad · Muratcan KoylanDiagnostica fallos en contextos largos y planifica la recuperación con hechos verificados y comparaciones de tareas reales.Skill Advanced Evaluation
Comunidad · Muratcan KoylanDiseña jueces LLM con rúbricas basadas en pruebas, comparaciones invertidas y calibración humana.Skill Brainstorming
Comunidad · Jesse Vincent / Prime RadiantConvierte una idea inicial en un diseño acordado antes de implementar.Skill Writing Plans
Comunidad · Jesse Vincent / Prime RadiantConvierte un diseño aprobado en tareas revisables con interfaces y verificación.