Instalar y gestionar skills

Esta guía te muestra cómo llenar un espacio de trabajo con skills de GitHub: añade un repositorio como fuente, instala las skills que quieras de él y mantenlas al día con el tiempo.

Lo más importante que debes saber antes de empezar: un repositorio de origen no es de confianza. Su nombre, su descripción y su número de estrellas los escribe quien lo posee. La única señal de seguridad en la que Control Center confía es el veredicto del análisis antivirus, por el que pasa toda instalación antes de que nada llegue al disco o al prompt de un agente. Si quieres el razonamiento, lee la sección sobre skills del modelo de agentes; esta página se queda en el cómo.

Las skills viven en Ajustes → Espacio de trabajo → Habilidades (/workspaces/<id>/settings/workspace/skills). Tienen alcance de espacio de trabajo: las skills que instales aquí pertenecen solo a este espacio. La página tiene dos pestañas: Instaladas (skills locales, incluido un editor Nueva habilidad) y Fuentes (catálogos de GitHub). Ambas escrituras pasan por el mismo filtro del análisis.

Añadir un repositorio de skills

Abre Ajustes → Espacio de trabajo → Habilidades y cambia a la pestaña Fuentes.
Pulsa Añadir repositorio.
Pega la URL de un repositorio de GitHub, por ejemplo https://github.com/anthropics/skills, y confirma.

El servidor comprueba que el repositorio existe y es visible con sus credenciales, y después lo añade a la barra lateral izquierda. En medio no hay ninguna tienda curada: cualquier repositorio de GitHub sirve, lo que también significa que la reputación la juzgas tú — un número de estrellas es una evidencia, nunca una garantía.

Las skills de un repositorio son los directorios que contienen un SKILL.md (hasta tres niveles de profundidad, más la disposición del marketplace de plugins de Claude plugins/<plugin>/skills/<skill>; los árboles de dependencias y de terceros se omiten). Si más tarde la cuadrícula dice que el repositorio no tiene skills, eso es lo que significa: ningún directorio de él sigue la convención de skills.

Inspeccionar una skill antes de instalarla

Selecciona un repositorio en la barra; sus skills aparecen como una cuadrícula a la derecha, con un campo de filtro encima que acota el catálogo por nombre, descripción o slug. Haz clic en una tarjeta para abrir la vista de detalle. Muestra tres cosas:

El README, renderizado como markdown — el README.md del directorio de la skill, o el cuerpo del SKILL.md cuando no hay README.
La vista previa del análisis — el veredicto (pass, warn o quarantine), las capacidades que declara el contenido de la skill (ejecuta el shell, escribe archivos, acceso a la red…) y cada hallazgo que registró el escáner.
El recuento de archivos — una instalación escribe todo el directorio de la skill, no solo su SKILL.md.

La vista previa analiza exactamente los bytes que escribiría una instalación, así que el veredicto que ves es el veredicto que obtiene la instalación; no se vuelve a juzgar nada a tus espaldas.

Instalar una skill

Abre la vista de detalle de la skill.
Lee el veredicto del análisis. Si el veredicto es warn o pass, pulsa Instalar.
Si el veredicto es quarantine, la instalación permanece desactivada hasta que marques Entiendo el riesgo — instalar de todos modos. Esa anulación se registra, no se da por supuesta.

La instalación escribe el directorio de la skill en el espacio de trabajo, registra un pin en skills-lock.json (repositorio de origen, ruta, el commit del que procede y un hash del contenido), y la skill queda disponible para los agentes del espacio de trabajo. Una tarjeta marcada como Nombre en uso significa que otra skill ya posee ese nombre en local — desinstala esa primero.

Actualizar skills con el tiempo

Las tarjetas de las skills instaladas llevan insignias: Instalada, o Actualización disponible cuando el repositorio ha avanzado más allá del commit que fijaste. Abre la vista de detalle y pulsa Actualizar para volver a obtenerla en el nuevo commit. Una actualización pasa por el mismo filtro del análisis que una instalación — una skill cuya nueva versión quede en cuarentena se rechaza y la versión que tenías se queda como estaba. El hash de la versión antigua se conserva como referencia de reversión en el archivo de bloqueo.

Desinstalar una skill, quitar un repositorio

Desinstalar (en la vista de detalle de una skill instalada, o eliminar en la pestaña Instaladas) quita el directorio de la skill y su pin del archivo de bloqueo a la vez — una skill desinstalada no deja nada atrás.

Quitar un repositorio de la barra elimina solo el catálogo: las skills que instalaste de él siguen instaladas y se siguen actualizando, porque un pin registra el repositorio por su nombre y no como una referencia a la entrada de origen. Vuelve a añadir el repositorio si quieres explorarlo otra vez.

Invocar una skill

Las skills se invocan bajo su propio espacio de nombres, así que nunca chocan con los comandos slash integrados (/plan, /goal, /loop, /compact):

/skill:<name> — una skill instalada en este espacio de trabajo, o asociada al agente
/skill:<repo>:<name> — una skill que aporta un repo clonado en este espacio

Un nombre simple que no sea integrado todavía se resuelve, para los mensajes escritos antes de que existiera el espacio de nombres. /skill:plan es lo que llega a una skill llamada plan; /plan es siempre el integrado.

Skills con alcance de repo

Un repo clonado puede aportar sus propias skills, en .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ o skills/. Esas no se instalan desde esta página. Un agente solo lleva las skills del repo en el que está trabajando en ese momento; cambian cuando él cambia. El compositor no tiene ese alcance: /skill:<repo>:<name> llega a cualquier repo del espacio.

Las skills de repo pasan por el mismo análisis que bloquea ante la duda (pass / warn / quarantine) antes de que su frontmatter llegue a un prompt. warn se admite; quarantine se retiene, sin ninguna anulación del operador en esa ruta.

Consulta Skills con alcance de repo y Comandos slash.

Guías relacionadas

Conceptos relacionados

El modelo de agentes