# Trabajar con skills

> Agrega una skill del catálogo o escribe la tuya, edítala, recupera versiones, archívala en proyectos y elige qué skills están activas.

Source: https://endless.okinawa/es/docs/automate/skills

Una skill es un conjunto de instrucciones que Endless carga cuando una tarea lo necesita. Esta
página explica cómo agregar, editar y activar skills. Para saber qué es una skill, mira [skills y
conocimiento](/es/docs/concepts/skills-and-knowledge).

**Skills** en la barra lateral lista todas las skills que puedes abrir: las tuyas, las compartidas
contigo o con el espacio de trabajo, y las integradas. Cada fila muestra su origen
(**Integrada**, **Del workspace** o **Comunidad**), el acceso, la descripción y tu interruptor.
Busca por nombre o filtra por creador, acceso, proyecto y **Origen**.

<ImageZoom src="https://static.endless.software/docs/screenshots/skills-list-0bc24b3c.webp" alt="La página de Skills: un banner que invita a explorar el catálogo con tres libros de skills en abanico a la derecha, una barra de filtros y búsqueda, y la lista de skills, cada una con su nombre, su origen, su descripción, quién la creó, la última actualización y un interruptor; una fila está apagada y una integrada dice que está desactivada para el espacio de trabajo" width="1280" height="720" />

## Agregar una desde el catálogo

<Steps>
  <Step>
    ### Abre el catálogo

    **"Explorar skills"** en la página de Skills abre skills hechas por Endless o adaptadas de la
    comunidad, agrupadas por categoría.
  </Step>

  <Step>
    ### Abre una ficha

    Muestra qué hace la skill, quién la hizo, cuántas veces se usó y los archivos que trae.
  </Step>

  <Step>
    ### Agrégala

    **"Agregar a mis skills"*&#x2A; la copia a tu espacio de trabajo como una skill privada que puedes
    editar, compartir y archivar en proyectos. O elige un ejemplo en &#x2A;*"Pruébala"**: agrega la skill y
    abre un chat nuevo con el mensaje escrito, sin enviar.
  </Step>
</Steps>

<ImageZoom src="https://static.endless.software/docs/screenshots/skills-explore-fc4762b9.webp" alt="El catálogo de skills: pestañas de categorías de Todas a Diseño sobre una grilla de fichas, cada una dibujada como la tapa de un libro de color junto a su título, resumen, autor y cantidad de usos; la primera está marcada como agregada" width="1280" height="720" />

Tu copia no cambia sola. Cuando el catálogo tiene una versión más nueva, la página de la skill
muestra un botón &#x2A;*"Actualizar"**; tus instrucciones anteriores quedan en su historial. Cada
persona puede tener una copia de cada ficha.

## Escribir la tuya

**"Nueva skill"** ofrece:

| Vía                     | Entrada                                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Subir**               | Un paquete `.zip` o `.skill`, o un solo `SKILL.md`. Los archivos binarios o muy grandes se omiten y se cuentan.             |
| **Pegar**               | El texto del `SKILL.md`. El nombre y la descripción se leen de su frontmatter.                                              |
| **Desde URL**           | Una URL de skills.sh o de GitHub. **Obtener**, revisa lo que se cargó y agrégala.                                           |
| **Crear con el agente** | Desde la flecha junto a &#x2A;*"Nueva skill"**, o pídelo en cualquier chat. Endless la redacta y la guarda cuando apruebas. |

También puedes elegir &#x2A;*"Crear skill"** en el menú de uno de tus propios mensajes de chat. Todas
las vías terminan con una revisión de **Nombre**, **Descripción*&#x2A; y acceso antes de &#x2A;*"Crear
skill"**.

<Callout type="warn">
  Endless lee la descripción en cada mensaje para decidir cuándo cargar la
  skill. Escríbela como cuándo usar la skill, en menos de 1.000 caracteres.
</Callout>

Agregar o crear una skill necesita permiso para crear contenido (miembros y administradores por
defecto, los lectores no). Una skill nueva es **Privada** hasta que la compartes. El `SKILL.md`
tiene un límite de 64KB; pon el material de referencia largo en un archivo aparte, que Endless lee
solo cuando lo necesita.

## Editar una skill

Abre una skill para ver su descripción, creador, proyectos, estado y árbol de archivos. Edita un
archivo y guarda con **⌘S** (**Ctrl+S**). **Compartir** e **Historial** están en el encabezado.

<ImageZoom
  src="https://static.endless.software/docs/screenshots/skills-db4bc8cf.webp"
  alt="
  'Una skill llamada &#x22;Brand voice&#x22; abierta en su propia página: el árbol de archivos a la izquierda con SKILL.md, una carpeta de referencias y otra de scripts; a la derecha su descripción, quién la creó, el proyecto en el que está y un interruptor encendido sobre una vista previa de SKILL.md; Historial y Compartir están en el encabezado'
"
  width="1280"
  height="720"
/>

* Quien la creó la edita, comparte y elimina. Las personas con **Puede editar** pueden editarla;
  solo quien la creó cambia con quién se comparte. Las skills integradas no se pueden editar,
  eliminar ni compartir. Permisos sobre contenido de otros: [roles y
  permisos](/es/docs/governance/roles-and-permissions).
* Cuando Endless quiere cambiar una skill durante un chat, muestra una tarjeta para que la
  apruebes o la descartes. Si no puedes editar la skill, dice que el cambio no se guardó.
* **Historial*&#x2A; guarda cada versión, la primera y las últimas 100. &#x2A;*"Restaurar"** agrega la
  versión anterior como una nueva.
* **Eliminar** mueve la skill a **Configuración → Papelera** durante 30 días; después se borra
  para siempre. Quien podía eliminarla puede restaurarla. Una copia del catálogo no se puede
  restaurar mientras tengas una copia más nueva de la misma ficha.

## Activar y desactivar skills

Se aplican dos interruptores, y el del espacio de trabajo gana:

| Nivel              | Dónde                                                          | Efecto                                                                           |
| ------------------ | -------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| Personal           | El interruptor de cada fila en la página de Skills             | Activa o desactiva solo para ti                                                  |
| Espacio de trabajo | **Configuración → Gobernanza → Skills**                        | Desactivar la quita para todos; activar solo la deja disponible                  |
| Miembro            | El perfil de un miembro en **Miembros**, pestaña **Funciones** | Ajusta la skill de una persona; antes debe estar activa en el espacio de trabajo |

Donde el espacio de trabajo tiene una skill desactivada, tu interruptor muestra el distintivo
bloqueado &#x2A;*"Desactivado para el espacio de trabajo"**. Cambiar los niveles de espacio de trabajo
y de miembro necesita el permiso de gobernanza (los administradores por defecto). Mira [roles y
permisos](/es/docs/governance/roles-and-permissions).

Una skill desactivada no se carga en ningún lado: chat, proyectos ni ejecuciones programadas.

## Skills en proyectos

La pestaña **Conocimiento*&#x2A; de un proyecto lista las skills archivadas ahí: &#x2A;*"Agregar skill"*&#x2A;
archiva una existente, &#x2A;*"Nueva skill"** escribe una en el proyecto. Todos los que pueden abrir el
proyecto pueden leer y usar una skill archivada. Es la misma skill en todos los lugares donde
está archivada.

Una skill archivada se carga en los chats que tienen ese proyecto adjunto; en otros lugares, solo
cuando la llamas con `/`. Igual respeta los interruptores. El conocimiento propio de un proyecto
no tiene interruptor y siempre se carga con el proyecto. Mira [proyectos](/es/docs/concepts/projects).

## Usar skills

* **En el chat**: una skill activa se carga cuando una tarea coincide con ella. Escribe `/` en el
  compositor para llamarla por nombre.
* **En [tareas programadas](/es/docs/automate/scheduled-tasks)*&#x2A;: las skills también se cargan en las
  ejecuciones. El control &#x2A;*"Conectores y skills"** de una programación puede desactivar skills
  solo para esa programación.

Relacionado: los [conectores](/es/docs/automate/connectors) dan a Endless acceso a herramientas externas.