Skills

Skills: crea, personaliza e importa

Redacta y valida SKILL.md, personaliza una skill de biblioteca, crea un borrador desde una rama e importa Markdown público o un ZIP con recursos.

Antes de empezar

Abre avatar → Skills o Skills → Gestionar skills… desde un cuadro de mensaje normal. Estos controles aparecen solo si tu cuenta tiene acceso a skills. Una skill necesita una cabecera YAML con name y description, seguida de instrucciones Markdown no vacías. Conserva reglas de proceso reutilizables, no una transcripción llena de datos de una sola tarea.

Revisa el contenido no fiable antes de añadirlo o usarlo. Las importaciones por URL, los borradores de ramas y los bloques de respuestas abren un editor antes de guardar; las subidas de archivos con metadatos válidos guardan directamente. No presupongas que toda importación tiene pantalla de revisión. Elimina tú los secretos y datos personales del borrador, aunque se haya pedido a la IA que los omita.

Cuándo te conviene

Escribe una skill nueva si conoces las reglas. Personaliza una de biblioteca si su proceso se acerca al tuyo. Convierte una rama que funcionó en borrador para capturar el tono, las comprobaciones y las correcciones útiles. Importa un archivo público o un ZIP si ya tienes las instrucciones y, opcionalmente, recursos de apoyo.

Pasos

Escribe en el editor. Pulsa Nueva skill. En SKILL.md, sustituye el nombre, la descripción y las instrucciones de la plantilla. Usa títulos para la tarea, pasos numerados para el proceso y reglas explícitas para el resultado. El primer encabezado escrito con #, ## o ### se convierte en el título visible; si no hay ninguno, el título se deriva de name. name es el identificador. Cambia a Vista previa para comprobar el texto renderizado y pulsa Guardar.
Pon metadatos válidos. name debe tener entre 1 y 64 caracteres: letras ASCII minúsculas, números y guiones simples que separen grupos no vacíos. Por ejemplo, informe-semanal es válido; Informe Semanal, informe--semanal y los guiones al principio/final no lo son. Tus skills propias necesitan nombres distintos. description es obligatoria, admite hasta 1.024 caracteres y debe explicar qué hace la skill y cuándo usarla. Coloca ambas claves entre las líneas --- de apertura y cierre de la plantilla. Entrecomilla los valores YAML con signos como dos puntos seguidos de un espacio. Deja las instrucciones debajo de la línea de cierre.
Mejora la descripción. Sugerir descripción propone metadatos a partir de las instrucciones. Puede sustituir el nombre de la plantilla, pero conserva un nombre distinto que ya hayas puesto. Lee y edita la sugerencia. Necesita un modelo potente (con Auto) establece una preferencia de nivel para la selección de modelo Auto; no compra acceso ni sustituye un modelo elegido manualmente. Si aparece, Probar activación → Probar comprueba si Jev elegiría la skill guardada para un mensaje de ejemplo, no si su respuesta sería correcta. Guarda los cambios antes de probar.
Personaliza una skill de biblioteca. En Explorar, abre una entrada y pulsa Duplicar y editar. Esto guarda inmediatamente una copia personal y abre su editor; Cancelar no deshace la duplicación. Cambia el texto y guarda. La copia conserva el nombre de biblioteca, sustituye a la original en tu cuenta, hereda su modo de uso y recibe sus fijaciones de espacios. La biblioteca original no se modifica. Esta duplicación copia instrucciones y metadatos, no archivos de recursos. Borra la copia personal para volver a ver la entrada de biblioteca; no esperes que se restauren automáticamente las fijaciones de la copia borrada.
Crea un borrador desde una conversación. En una respuesta normal completada del Lienzo, abre ⋮ → Crear skill desde esta rama. En Chat, usa la acción del mismo nombre bajo una respuesta; en pantallas estrechas puede aparecer como icono. El redactor lee la conversación que conduce a esa respuesta, incluidos prompts, respuestas y correcciones, no todas las ramas hermanas. Intenta extraer instrucciones reutilizables, generalmente en inglés con una regla para responder en el idioma del usuario. Revisa el borrador, ponle un nombre único y Guardar. Estos controles no están disponibles en respuestas Build ni en respuestas de decisión en Chat.
Guarda un bloque SKILL.md de una respuesta. Puedes seleccionar manualmente la skill de biblioteca skill-creator y pedir instrucciones reutilizables. Cuando una respuesta normal incluye un bloque de código con una cabecera completa de SKILL.md, aparece Guardar como skill en ese bloque. Abre el editor; revisa metadatos e instrucciones antes de Guardar. Un párrafo normal o un bloque sin name o description no recibe ese botón.
Importa una URL pública. Pulsa Desde una URL, pega una dirección HTTP(S) completa y Importar. Debe devolver Markdown legible públicamente, no HTML, una página de acceso ni un recurso de red privada. Las páginas reconocidas de archivos/carpetas de GitHub se convierten en una petición al SKILL.md sin formato. Revisa el texto en el editor y Guardar; las importaciones por URL empiezan en Solo si la elijo. La petición importa un archivo de instrucciones, no todos los recursos de su repositorio. No envía credenciales de acceso para recuperar un repositorio privado. Las comprobaciones de direcciones públicas, incluidos los destinos de redirecciones, protegen frente a peticiones del servidor a destinos internos (SSRF); no intentes eludir un bloqueo de dirección interna.
Sube Markdown o un ZIP de carpeta. Inspecciona primero el contenido local y pulsa Subir .md o .zip. El selector también acepta .markdown; prepara el Markdown como texto UTF-8. Si un .md no tiene cabecera, el formulario Nombre y descripción permite rellenar ambos campos, usar opcionalmente Sugerir nombre y descripción y pulsar Añadir skill. Un YAML existente incorrecto o incompleto debe corregirse en el archivo. El ZIP necesita SKILL.md, con ese nombre exacto, en la raíz del archivo o dentro de su única carpeta contenedora. Coloca los recursos bajo esa misma raíz, normalmente en references/, scripts/ o assets/. Se rechazan archivos ajenos fuera de la carpeta contenedora. Las subidas válidas guardan directamente y empiezan en Automática; revisa enseguida Uso si solo quieres elegirla manualmente.
Inspecciona los recursos y exporta. Abre la skill guardada y pulsa una ruta de Archivos para inspeccionar texto legible. Los binarios no tienen vista textual; exporta la skill para examinarlos localmente. Usa Exportar en la tarjeta para obtener un ZIP si tiene recursos o un .md en caso contrario. El editor cambia el texto de SKILL.md, no los recursos; para sustituirlos, prepara y revisa otro archivo con un nombre de skill distinto.

Ejemplo práctico

Crea informe-semanal con una descripción como «Redacta un informe semanal del proyecto. Úsala cuando pida un informe semanal o un resumen de estado». Sustituye las instrucciones por reglas para separar trabajo terminado, bloqueos, responsables y próximos pasos, y señalar fechas ausentes en vez de inventarlas. Pon un encabezado como «Informe semanal del proyecto», comprueba Vista previa y Guardar.

Elige Solo si la elijo, selecciónala para un mensaje y pruébala con notas de proyecto ficticias. Ajusta las reglas según el resultado. Si un agente necesita una lista de comprobación adicional, prepara un ZIP con informe-semanal/SKILL.md e informe-semanal/references/checklist.md. Pon otro nombre en la cabecera de la nueva importación si ya existe la original. Menciona la lista en las instrucciones; Chat no leerá automáticamente ese recurso.

Qué ocurre después

Las skills guardadas aparecen en Mis skills. Las creadas en el editor, los borradores de ramas y los bloques de respuestas empiezan como candidatas automáticas; las importaciones por URL y las copias añadidas desde vistas compartidas/de galería empiezan manuales. El modo Automática no activa la casilla de Lienzo/Chat. Guardar una skill no la ejecuta ni crea una respuesta. Elígela, fíjala o usa un agente apto como explica la guía de uso.

Lienzo/Chat aplica solo las instrucciones de SKILL.md. Los agentes con su interruptor independiente Usar skills y un modelo que admite herramientas pueden cargarlas mediante use_skill y leer recursos listados con read_skill_file. Si el ordenador está habilitado, disponible para la cuenta y configurado, los recursos de las skills cargadas se copian en /home/agent/skills/<name>/ cuando se usa una herramienta de ordenador. Esa copia contiene los archivos auxiliares, no un archivo SKILL.md recién exportado. Los scripts no se ejecutan por subir, seleccionar o leer una skill; un agente puede ejecutarlos explícitamente mediante una herramienta de ordenador como computer_shell. Esas llamadas integradas no usan la pausa de aprobación de las apps conectadas: inspecciona los scripts antes de permitir su uso.

Coste y límites

Crear, guardar o recuperar un archivo de instrucciones no genera una respuesta normal del modelo. El redactor desde una rama y el ayudante de metadatos no consumen tus créditos en la implementación actual, pero tienen límites de frecuencia/diarios y dependen de la disponibilidad del modelo. Las pruebas de activación de Jev son decisiones auxiliares, no ejecuciones completas; también tienen límites. Esto no promete acceso ilimitado ni gratuito permanente. Las respuestas que usan la skill se facturan normalmente, incluido su texto como tokens de entrada. Leer recursos añade contexto al agente; el ordenador y otras herramientas pueden añadir sus cargos habituales.

Los límites actuales de formato son 64 KiB para SKILL.md, 1.024 caracteres de descripción y un máximo predeterminado de 20.000 caracteres de instrucciones, que puede cambiar. Los límites ZIP son 5 MiB comprimidos, 10 MiB expandidos en total, hasta 50 archivos auxiliares y 2 MiB por archivo del ZIP; SKILL.md conserva su propio límite de texto. Las rutas deben ser relativas y seguras, de hasta 200 caracteres: se rechazan rutas absolutas, rutas con unidad, recorridos fuera de la raíz y enlaces simbólicos. Los nombres de carpetas y extensiones no constituyen una aprobación de seguridad; los scripts aceptados también necesitan revisión. Los recursos ZIP requieren almacenamiento de archivos disponible.

El índice del agente contiene por defecto como máximo 20 skills automáticas, con las descripciones largas recortadas; no es un catálogo ilimitado en cada ejecución. Las vistas de recursos textuales y lecturas del agente se limitan por defecto a los primeros 30.000 caracteres; los binarios devuelven un aviso de archivo binario, no texto utilizable. También se aplican los demás límites de modelo/contexto/herramientas. La estimación de tokens del editor es aproximada. Las creaciones y copias personales cuentan para el cupo de Mis skills; las entradas de biblioteca no.

Solución de problemas

Nombre inválido o repetido: usa minúsculas/números con guiones simples de separación y elige otro nombre personal. Cambiar solo el nombre del archivo no cambia el name de la cabecera.
YAML inválido, descripción ausente o cuerpo vacío: conserva los dos delimitadores ---, claves y valores válidos, una descripción e instrucciones reales bajo la cabecera. Corrige localmente el YAML subido y vuelve a subirlo.
No aparece Guardar como skill: la respuesta necesita un bloque de código con la cabecera completa; no basta con instrucciones Markdown normales. Pega el archivo completo en Nueva skill.
El borrador de rama está incompleto: las conversaciones largas se recortan al inicio y los turnos recientes. Añade tú las reglas reutilizables que falten. No se puede redactar desde una rama borrada.
La importación da error de página web: usa el archivo Markdown público sin formato, no la portada de un sitio o una página de acceso. Los hosts privados, redirecciones no seguras, tiempos de espera y archivos grandes pueden bloquear la petición.
El ZIP no tiene SKILL.md o sus rutas son inseguras: comprueba mayúsculas exactas, posición en la raíz, carpeta contenedora única y elimina enlaces o entradas inseguras. No comprimas varias carpetas de skills distintas juntas.
La subida guardó sin vista previa: es lo esperado con subidas .md/ZIP válidas. Inspecciona antes los archivos y después abre la skill guardada y revisa su modo antes de usarla.
No se pueden guardar o copiar archivos: quizá el almacenamiento no esté disponible. Reintenta más tarde o usa solo instrucciones si no necesitas recursos. Duplicar desde la biblioteca no copia recursos; las copias compartidas/de comunidad sí.
Un agente no puede usar un recurso: comprueba que esté listado y sea legible, que su interruptor Usar skills esté habilitado y que haya acceso al ordenador para scripts/binarios. Las lecturas largas pueden truncarse.
No aparece la prueba de activación o no es concluyente: la selección automática puede estar desactivada o no disponible. Prueba manualmente las instrucciones guardadas con un ejemplo ficticio; la prueba de activación no verifica la calidad de la tarea.

Guías relacionadas

Para trabajar con agentes, consulta también estas guías de Spools: