BWBYB/agent-skills

Constructor de Skills Personales

Crea skills pequeños y descubribles que mejoren las decisiones del agente para un flujo de trabajo específico y repetible.

Alcance

Usa este skill para un skill nuevo o para un cambio enfocado en un skill existente. Preserva la ubicación solicitada por el usuario, la política de invocación y los límites de autorización. No crees un skill simplemente para contener consejos genéricos que el agente ya conoce.

Flujo de trabajo

1. Define el límite de la tarea antes de escribir archivos:

   • ¿Qué resultado repetible proporciona el skill?
   • ¿Qué solicitudes deberían activarlo y cuáles similares no deberían?
   • ¿Qué entradas, herramientas, efectos secundarios y comprobaciones de finalización son importantes?

2. Inspecciona un skill existente antes de cambiarlo. Conserva los recursos y políticas útiles; no reinicies un directorio existente.

3. Elige la estructura más pequeña:

   • SKILL.md es obligatorio.
   • Agrega references/ solo para material sustancial y condicional que cambie las decisiones.
   • Agrega scripts/ solo para trabajo repetitivo o determinista donde la ejecución mejore la fiabilidad.
   • Agrega assets/ solo para archivos utilizados en la salida generada.

4. Escribe SKILL.md:

   • El name en el frontmatter debe estar en minúsculas con guiones, coincidir con el directorio y tener como máximo 64 caracteres.
   • La description debe indicar tanto lo que hace el skill como cuándo se aplica; incluye un límite cuando evite un enrutamiento incorrecto.
   • Mantén el cuerpo enfocado en los resultados, reglas no obvias, orden de ejecución, puntos de confirmación y comprobaciones de finalización.
   • Coloca el detalle condicional en un recurso vinculado y especifica exactamente cuándo leerlo.

5. Valida el resultado con el validador de skills disponible cuando el entorno lo proporcione (localiza quick_validate.py bajo el skill skill-creator instalado):

   python3 <skill-creator>/scripts/quick_validate.py /ruta/al/skill
   

   Si no hay validador disponible, realiza manualmente las comprobaciones equivalentes de frontmatter, nombres, enlaces a recursos, marcadores de posición y scripts. Ejecuta los scripts añadidos cuando sea práctico.

Reglas de diseño

• Trata la descripción como una condición de enrutamiento, no como un catálogo de características.
• Mantén las instrucciones compartidas lo suficientemente cortas para una carga rutinaria; no copies una especificación externa completa en el punto de entrada.
• Prefiere un alcance explícito y criterios de finalización observables sobre prohibiciones amplias o adjetivos de calidad vagos.
• No agregues archivos README, ejemplos, plantillas o directorios de recursos sin un flujo de trabajo concreto que los utilice.
• Preserva los campos existentes de frontmatter y de agents/openai.yaml al actualizar un skill.
• Mantén el descubrimiento automático habilitado a menos que el usuario solicite explícitamente la invocación solo explícita.

Referencias

Lee la especificación de Agent Skills cuando la portabilidad, los campos de frontmatter, los límites de nombres o el comportamiento de carga sean inciertos. Trata cualquier guía de diseño proporcionada por el usuario o local de la máquina como una fuente opcional de preferencias: léela solo cuando el usuario solicite explícitamente esas convenciones o la tarea dependa de ellas, y no copies su contenido completo en el skill. Consulta un skill skill-creator instalado para detalles sobre el inicializador, metadatos de UI o validación en lugar de depender de una ruta absoluta específica de la máquina.