Objetivo del tema
Comprender el formato Agent Skills, activar skills en Bionic, convertir un flujo exitoso en instrucciones reutilizables, probar su comportamiento, instalar skills externas y distribuirlas con controles de seguridad y mantenimiento.
Una skill es una carpeta cuyo archivo principal se llama exactamente SKILL.md. Contiene metadatos para que el agente sepa cuándo usarla e instrucciones Markdown para ejecutar el flujo. Opcionalmente puede incluir scripts, referencias, plantillas, imágenes u otros recursos.
Bionic implementa el estándar abierto Agent Skills y puede usar skills instaladas, creadas en una conversación o compatibles con otras aplicaciones como Codex y Claude Code.
Ejemplos apropiados: revisar contratos contra una lista, crear informes con el estilo del equipo, analizar un CSV con controles definidos o preparar una publicación mediante un proceso estable.
No crees una skill para una pregunta única, una preferencia de una sola sesión o datos que cambian constantemente. Los secretos tampoco deben incrustarse en una skill.
| Mecanismo | Función | Ejemplo |
|---|---|---|
| Prompt | Instrucción puntual para el objetivo actual. | «Resume estas tres propuestas.» |
| Archivo de referencia | Datos o reglas que el agente debe consultar. | Manual de marca, esquema o tabla de precios. |
| Skill | Procedimiento reutilizable con criterios, ejemplos y recursos. | Generar siempre el mismo tipo de acta. |
| MCP o aplicación conectada | Acceso operativo a un servicio o fuente externa. | Consultar incidencias o crear una tarea remota. |
Una skill puede indicar cómo usar una herramienta, pero no reemplaza la conexión, las credenciales ni los permisos de esa herramienta.
El formato está diseñado para ahorrar contexto:
La descripción es decisiva: si es demasiado vaga, la skill no se activa cuando corresponde; si es demasiado amplia, puede intervenir en tareas equivocadas.
Bionic puede elegir una skill cuando su descripción coincide con el pedido. Formula el objetivo normalmente y observa en la conversación si la skill fue utilizada.
La selección automática depende de la calidad de la descripción y de la capacidad del modelo para seguir herramientas e instrucciones.
La invocación explícita es preferible cuando necesitas una skill determinada o estás probando una versión nueva.
SKILL.md es obligatorio. Las otras carpetas son convenciones del estándar y sólo deben existir cuando aportan valor. Usa rutas relativas desde la raíz de la skill para mencionar recursos.
El archivo contiene frontmatter YAML entre delimitadores --- y luego instrucciones Markdown:
| Campo | Requisito y función |
|---|---|
name | Obligatorio. Entre 1 y 64 caracteres; minúsculas, números y guiones; coincide con la carpeta; sin guiones al inicio o final ni dobles. |
description | Obligatorio y no vacío, hasta 1024 caracteres. Explica qué hace y cuándo debe utilizarse. |
license | Opcional. Identifica la licencia o remite a un archivo incluido. |
compatibility | Opcional. Declara plataforma, paquetes, red u otros requisitos especiales. |
metadata | Opcional. Pares clave-valor como autor o versión. |
allowed-tools | Opcional y experimental. Su soporte puede variar entre aplicaciones; no debe asumirse como control universal. |
La descripción debe combinar capacidad y disparadores concretos.
| Tipo | Ejemplo | Problema o ventaja |
|---|---|---|
| Débil | «Ayuda con documentos.» | No explica formato, proceso ni cuándo activarse. |
| Demasiado amplia | «Usar para cualquier tarea de oficina.» | Interfiere con pedidos que necesitan otras skills. |
| Precisa | «Convierte notas de reuniones en actas con decisiones, acciones, responsables y fechas.» | Define entrada, resultado y vocabulario de activación. |
Una skill eficaz contiene:
Escribe instrucciones directas. Una skill no necesita explicar conceptos generales que el modelo ya domina; debe conservar las decisiones específicas que hacen repetible el trabajo.
Indica dentro de SKILL.md cuándo leer cada referencia o ejecutar cada script. Evita cadenas profundas de documentos enlazados. La especificación recomienda mantener las instrucciones principales por debajo de 500 líneas y aproximadamente 5000 tokens, trasladando el detalle condicional a recursos.
Un script aporta determinismo para validar JSON, calcular totales o transformar archivos. También puede leer, modificar, eliminar o enviar datos. Antes de incluirlo:
Cuando una tarea termina bien, pide a Bionic que capture el flujo:
Bionic puede formular preguntas y luego producir la skill. Las versiones actuales también ofrecen el comando /create-skill y sugerencias de creación desde el compositor.
Describe el proceso futuro, sus entradas y estándares aunque aún no exista una ejecución previa:
Bionic admite varios caminos documentados:
/install-skill disponible en versiones recientes.SKILL.md existente desde Settings → Skills.Ve a Settings → Skills → Use skills found in other apps para controlar skills compatibles detectadas en otras aplicaciones. Puedes habilitar la integración y desactivar elementos individuales desde el menú •••.
Que una skill sea compatible en formato no garantiza que sus herramientas, rutas o comandos existan en Bionic. Revisa el campo de compatibilidad y adapta instrucciones específicas de cada aplicación.
| Área | Qué comprobar |
|---|---|
| Origen | Autor, repositorio real, versión, historial y mecanismo de actualización. |
| Instrucciones | Objetivo, acciones prohibidas, intentos de ignorar al usuario o ampliar permisos. |
| Scripts | Lectura, escritura, eliminación, red, procesos y dependencias. |
| Datos | Archivos que consulta, información enviada y registros que conserva. |
| Credenciales | Variables, tokens, cuentas y alcance solicitado. |
| Licencia | Derecho a utilizar, modificar y redistribuir recursos incluidos. |
Una prueba completa evalúa dos cosas distintas:
Crea entre cinco y diez consultas nuevas con positivos y negativos. Prueba también entradas incompletas, datos contradictorios y ausencia de herramientas. Para criterios mecánicos, como un JSON válido o columnas obligatorias, utiliza validación programática cuando sea posible.
Una skill es una carpeta portable. Para compartirla de forma responsable:
Controla los cambios con Git y registra modificaciones de comportamiento. No actualices silenciosamente una skill utilizada en procesos regulados o de producción.
Crea un proyecto llamado Laboratorio de Skills. Invoca /create-skill o pide a Bionic que cree la skill con esta especificación:
Comprueba que el acta registre la decisión, asigne a Luis la acción con fecha 15 de septiembre y marque como pendiente el horario exacto. No debe inventar apellidos, asistentes ni una hora.
| Consulta | Resultado esperado |
|---|---|
| «Convierte estas notas en un acta.» | Debe activar la skill automáticamente. |
| «Revisa si esta acta tiene acciones sin responsable.» | Debe activar la skill. |
| «Redacta una invitación para la próxima reunión.» | No debe activarla. |
| «Resume este artículo sobre reuniones eficaces.» | No debe activarla. |
Cuando detectes un error repetible, decide si corresponde:
Incrementa su versión, repite las pruebas positivas y negativas y conserva un registro breve de cambios.
| Problema | Comprobación o solución |
|---|---|
| No aparece en la paleta. | Comprueba SKILL.md, YAML, nombre de carpeta y que esté habilitada en Settings. |
| No se activa automáticamente. | Haz la descripción más concreta, prueba palabras habituales o invócala con @. |
| Se activa demasiado. | Limita la descripción y agrega casos explícitos de no activación. |
| Ignora un recurso. | Referencia la ruta relativa y explica exactamente cuándo debe leerlo. |
| Falla un script. | Revisa compatibilidad, dependencias, permisos, directorio y entradas. |
| Funciona en otra app pero no en Bionic. | Busca comandos, rutas o herramientas específicas y adapta la compatibilidad. |
| Una actualización cambia resultados. | Fija versión, revisa el diff y repite las pruebas antes de adoptarla. |
SKILL.md.En el próximo tema conectaremos Bionic con servicios y herramientas externas mediante MCP y aplicaciones conectadas.
Fuentes oficiales consultadas: documentación de Skills en Bionic, presentación oficial de Skills, cambios recientes de creación, instalación y compatibilidad, descripción del estándar Agent Skills, especificación de SKILL.md y buenas prácticas de diseño y carga progresiva.