Skills

Una skill es saber hacer algo, puesto en un archivo: los pasos, las reglas y los ejemplos para un tipo de tarea. Los agentes ven el nombre y la descripción de una línea de cada skill, y cargan el texto completo solo cuando una tarea lo necesita. Así, cien skills casi no cuestan nada hasta que se usan.

Cómo es una skill

Una skill es una carpeta con un SKILL.md. El frontmatter tiene name y description; el cuerpo es el saber hacer.

weekly-report/SKILL.md

---
name: weekly-report
description: Writes the Friday status report from this week's closed tasks. Use when asked for the weekly report.
---
# Weekly report

1. List the tasks closed since Monday with `task_list`.
2. Group them by project, one line each, newest first.
3. End with what is still blocked and who it waits on.

Lo que más importa es la descripción: es lo que leen los agentes para decidir si cargar la skill. Decí cuándo usarla, no solo qué es. Los nombres usan letras, números, puntos, - y _.

Skills globales y de proyecto

• Directorio~/.apx/v2/skills/ globales: las heredan todos los proyectos

  • Directorioweekly-report/

    • SKILL.md
• Directorio~/work/acme-store/.apc/skills/ solo de este proyecto

  • Directoriorelease-notes/

    • SKILL.md

• Las globales viven en la carpeta de APX (~/.apx/v2/skills/). Las heredan todos los proyectos; un proyecto puede apagar una para sí mismo, o dejar de usar las globales del todo.
• Las de proyecto viven en .apc/skills/ del proyecto, viajan con el repositorio y solo las ven sus agentes.
• También pueden venir de una extensión.
• Las skills de otras apps de agentes también están, leídas donde esas apps las guardan: ~/.claude/skills, ~/.codex/skills, ~/.cursor/skills y ~/.agents/skills (globales), y .claude/skills, .codex/skills… dentro de un proyecto. Cada una muestra la etiqueta de su app (Claude, Codex, Cursor, Agents) y en APX es de solo lectura: cambiala en su app, o Copiar a APX.
• Un mismo nombre en dos lugares es una sola skill: gana la del proyecto, después la de APX, después las de otras apps y por último las de extensiones. Las demás se marcan Duplicada y aparecen en También en, diciendo si cada una es igual o distinta.

Se manejan en Recursos › Skills: leer, editar, crear (+ Skill) y prender o apagar cada una globalmente o por proyecto. Si editás una skill global desde adentro de un proyecto, APX te pregunta si cambiar la original o darle a ese proyecto su propia copia. Arriba de la lista podés ver solo las del proyecto (Todas / Proyecto) y filtrar por motor (APX, Claude, Codex, Cursor, Agents; varios a la vez).

Importar skills

+ Skill › Importar trae skills desde una carpeta, un .zip o un repositorio git (https o ssh; un link de GitHub a una carpeta trae solo esa carpeta). APX primero lo lee y no ejecuta nada: ves cada skill que encontró, sus archivos, los scripts que trae, la configuración que solo lee otra app (como allowed-tools) y lo que quedó afuera (links, archivos demasiado grandes). Marcás las que querés copiar; un nombre que ya existe se mantiene salvo que elijas reemplazarlo. Dentro de un proyecto van a su .apc/skills/.

APX

Recursos › Skills

Cómo las eligen los agentes

Cada agente recibe un catálogo corto de las skills que puede usar. Con un motor de embeddings configurado (Configuración › Memoria › Elegir skills por significado), cada mensaje que mandás además se compara por significado con tus skills, y hasta tres que encajan se le sugieren al agente para ese turno. El agente las evalúa y carga las que necesita con load_skill. La elección se ve como chips sobre la respuesta: cargada, sugerida o considerada.

Para cargar una vos, nombrala en el compositor: escribí / y elegila, o escribí /weekly-report. Su texto completo entra en ese turno, haya o no motor de embeddings. /skills abre la lista de skills.

Nota

Los chats con contactos en los canales y las sesiones de motores externos (Claude Code, Codex) no reciben las skills de APX.

Desde la terminal

apx

❯ apx skills
weekly-report                    global   Writes the Friday status report from this week's closed tasks. Use when asked for the week
daily-brief                      global   Writes a short morning brief from the owner's open tasks and commitments.

apx skills <proyecto> las lista como las ve un proyecto.

apx skills import https://github.com/acme/skills                 # lista lo que hay; no copia nada
apx skills import https://github.com/acme/skills --only pdf --yes
apx skills import ./pack.zip --project <proyecto> --yes          # a .apc/skills/ de ese proyecto
apx skills import ~/.claude/skills/pdf --yes                     # copia a APX una skill de otra app

Enseñale a otras apps de agentes a usar APX

APX trae unas skills para otras apps de agentes, así Claude Code, Codex, Cursor y todo lo que lea ~/.agents sabe usar APX (apx, apx-mcp, apx-extensions, apc-context). El core las copia en la carpeta de skills de cada app cada vez que arranca, solo para las apps que tenés instaladas. Para actualizarlas ahora, o ver qué cambiaría:

apx skills install-runtimes --dry-run
apx skills install-runtimes

Solo toca las skills que trae APX (y quita las que ya no trae), nunca las de otros. Mirá Clientes externos para conectar esas apps a tus agentes.