Documentación

MCP Fusion/Operate and integrate/Skills

Skills

Pregunta a la IA sobre Vinkius

SKILL.md es un contrato de arquitectura ejecutable que tu agente de codificación con IA sigue: tú eres el arquitecto, el agente escribe código MVA y @mcpfusion/skills distribuye las instrucciones de forma progresiva.

MCP Fusion incluye un contrato de arquitectura legible por máquina llamado SKILL.md. Le dice a los agentes de codificación con IA cómo es el código MCP Fusion correcto: cada herramienta necesita un Presenter con .returns(), los campos sensibles necesitan .redactPII(), las herramientas vienen de f.query, f.mutation y f.action. Tú eres el arquitecto. La IA escribe el código, y el contrato lo mantiene dentro del patrón.

Qué hace el scaffold

npx @mcpfusion/core create escribe el SKILL.md en tu proyecto y lo inyecta en los archivos de reglas que tus agentes ya leen:

  • .cursorrules para Cursor
  • .windsurfrules para Windsurf
  • .clinerules para Cline

A partir de ahí, pedirle a tu agente "una herramienta que lista facturas impagas" produce código MVA: un builder, un Presenter, redacción donde haga falta, nada de JSON.stringify crudo. El contrato es explícito con el fallo: cualquier herramienta sin un Presenter con .returns() es una salida incorrecta, y el agente se corrige.

Pídele a tu agente que lea el contrato antes de escribir nada: es un solo archivo, y codifica cada convención de esta sección de la documentación. Actualízalo a medida que evolucionen las convenciones de tu equipo.

Divulgación progresiva con @mcpfusion/skills

Meter una arquitectura entera en un prompt de sistema desperdicia contexto y entierra las reglas que importan para la tarea en curso. @mcpfusion/skills distribuye las instrucciones en tres capas:

  1. La capa de contrato. Un resumen corto, siempre cargado, de las reglas MVA.
  2. La capa de recetas. Instrucciones por tarea, cargadas cuando la tarea coincide: añadir una herramienta, componer Presenters, escribir pruebas.
  3. La capa de referencia. La superficie completa de la API, cargada bajo demanda.

El agente carga la capa dos solo cuando toca esa tarea, y la capa tres solo cuando necesita una firma exacta. Las sesiones largas de codificación reservan su presupuesto de contexto para el propio código.

bash
npm install @mcpfusion/skills

Lo que el contrato impone

ReglaPor qué existe
Cada herramienta adjunta un Presenter con .returns()La capa de percepción es el firewall de salida
Los campos sensibles pasan por .redactPII()La PII nunca llega al modelo
Las herramientas vienen de f.query, f.mutation, f.actionLas anotaciones MCP siguen siendo veraces
Nada de respuestas JSON.stringify crudasDatos sin forma son datos sin revisar
Los handlers devuelven Result para fallos esperadosErrores sobre los que el agente puede actuar

Próximos pasos