Tu agente de programación tiene una única personalidad por defecto: la de un generalista competente. Pídele que revise un flujo de autenticación y obtendrás consejos sensatos pero olvidables. Pídeselo a un revisor de seguridad con un modelo de amenazas y una lista de verificación, y obtendrás hallazgos. Esa diferencia no cuesta más que un archivo markdown, y por eso agency-agents ha alcanzado las 149.312 estrellas.
La biblioteca es realmente útil. También es una carpeta de archivos en una sola máquina, lo que se convierte en una limitación en cuanto más de una persona necesita que los roles signifiquen algo. Este artículo repasa qué obtienes, cómo instalar solo la parte que te interesa y la diferencia entre una definición de rol y un Agent al que un equipo puede asignarle trabajo.
TL;DR
Este es uno de los cinco análisis en profundidad de nuestra recopilación de herramientas de código abierto que amplían las capacidades de los agentes de programación.
agency-agents es una colección de más de 300 definiciones de roles de agentes repartidas en unas 20 categorías, con licencia MIT, que se instala en Claude Code, Cursor, Codex, Gemini CLI, OpenCode y alrededor de una docena de herramientas más con un solo comando. Cada archivo describe una identidad, un proceso de trabajo, entregables y una definición de «terminado». Un rol cambia cómo un agente enfoca una tarea; no le aporta información de la que carece ni se conserva más allá de la sesión. Instala una división, edita los archivos para que encajen con tu stack y promueve a configuraciones guardadas —que un equipo pueda asignar— aquellos que uses cada semana.
Qué estás instalando
Según el recuento hecho a partir del árbol del repositorio el 1 de septiembre de 2026, hay 312 archivos markdown repartidos en 20 carpetas de categorías de primer nivel. El README del repositorio todavía dice «230+», una cifra desactualizada.
| División | Archivos | División | Archivos |
|---|---|---|---|
| engineering | 59 | testing | 9 |
| specialized | 58 | paid-media | 7 |
| marketing | 36 | project-management | 7 |
| game-development | 21 | academic | 6 |
| integrations | 18 | spatial-computing | 6 |
| strategy | 16 | support | 6 |
| gis | 13 | finance | 5 |
| security | 12 | product | 5 |
| design | 10 | healthcare | 3 |
| sales | 9 | examples | 6 |
La división de engineering es donde empieza la mayoría de los equipos, y el nivel de detalle es mayor de lo que suele alcanzar una colección de prompts. Junto a Frontend Developer y Backend Architect hay un Network Engineer centrado en Cisco IOS-XE y Juniper Junos, un Embedded Firmware Engineer para objetivos ESP32 y STM32, un Incident Response Commander para post-mortems y preparación de guardias, y un Codebase Onboarding Engineer diseñado para explorar un repositorio en modo de solo lectura y exponer hechos en lugar de proponer cambios.
Ese último ejemplo demuestra que el patrón funciona. Un rol de solo lectura con un mandato explícito de no editar es una herramienta distinta de tu agente por defecto, y cuesta un solo archivo.
Instalar solo lo que necesitas
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh # interactive
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run
Una advertencia que el repositorio documenta y que la mayoría de los artículos omite: el runtime de OpenCode registra alrededor de 119 agentes y descarta el resto sin avisar. Instalar un subconjunto con --division te mantiene por debajo del límite, y el instalador te avisa cuando una selección lo superaría. El truncamiento silencioso es el peor modo de fallo posible, porque el rol que querías falta y nada te lo indica.
Incluso sin ese bug, instalar los 300 es un error. Una plantilla que no puedes recordar es una plantilla que no vas a usar. Instala la división en la que trabajas, lee cinco archivos y elimina los que no encajen con la forma de trabajar de tu equipo.
Dónde termina una definición de rol
Un rol es un marco. Define qué busca el agente, qué formato produce y qué considera terminado. Eso vale más de lo que parece, porque gran parte de lo que hace que la salida de un agente sea floja no es que el modelo se equivoque, sino que optimiza para la forma equivocada de respuesta.
Hay dos cosas que un rol no puede hacer.
No puede aportar información que el modelo no tiene. Un rol de Backend Architect produce código bien organizado contra una interfaz que ha inferido. El rol mejoró la estructura, pero no hizo que el resultado fuera correcto.
No sobrevive a la sesión. Activas un rol, hace una tarea y se cierra la terminal. Al día siguiente vuelves a escribir la activación. Nueve de las divisiones de este repositorio describen puestos que solo existen dentro de una organización, y la herramienta que las instala no tiene ningún concepto de organización. No hay asignación, ni registro de lo que encontró el revisor de seguridad el martes pasado, ni forma de que un colega vea nada de eso.
De una definición de rol a un Agent asignable
Una definición de rol es un prompt que vuelves a escribir. Un Agent en Sharkly es una configuración guardada: instrucciones, runtime, skills, repositorios y entorno. Esa es la versión duradera de lo que busca un archivo en ~/.claude/agents/.
Cada pieza tiene una sola función. El Agent define cómo debe gestionarse el trabajo. La Computer aporta el host y los recursos locales. El Runtime realiza la sesión del agente propiamente dicha, usando la herramienta de programación que tu equipo ya tiene instalada. La Task sigue siendo el registro compartido.
Sharkly no sustituye a Claude Code, Codex ni a los roles de este repositorio. Añade a su alrededor la capa de tarea compartida, Computer, contexto, control y revisión. El uso del modelo sigue gestionándose a través de las suscripciones o claves de API configuradas en esas herramientas.
El concepto de división se traduce directamente. Un Crew es un grupo reutilizable de People y Agents coordinado por un Agent líder. Los Crews funcionan con el líder primero: el líder lee el contexto de la tarea, decide qué miembros implicar y reúne sus resultados en una única Task, en lugar de que todos los especialistas empiecen a la vez. Eso es lo que agency-agents insinúa con sus ocho divisiones y no puede ejecutar, porque una carpeta de archivos no tiene líder ni una tarea compartida a la que volver.
La ejecución, los bloqueos, los resultados y el debate de seguimiento vuelven a la cronología de la tarea. Cuando alguien pregunta qué encontró el revisor de seguridad, la respuesta está en la Task.
Usa el repositorio como una biblioteca, no como un equipo
Usa agency-agents directamente cuando seas una sola persona, trabajes en local y quieras un mejor enfoque para el trabajo de hoy. Instala una división, lee los archivos y obtén valor en veinte minutos.
Usa Agents guardados cuando el rol tenga que reutilizarlo más de una persona, cuando el resultado necesite revisión antes de darlo por bueno o cuando alguien vaya a preguntar dentro de tres meses qué produjo un rol y por qué. El umbral no es el tamaño del equipo, sino si el rol tiene que sobrevivir a la sesión.
El flujo de trabajo práctico consiste en tratar el repositorio como material de partida. Toma la estructura de archivos, que es la parte realmente reutilizable, sustituye el contenido genérico por tu stack y tu definición de «terminado», y promueve a configuración guardada todo lo que uses dos veces por semana. Los buenos archivos comparten una misma forma: identidad, misión, proceso ordenado, entregables con un formato y criterios de éxito. Un rol de revisión con un proceso de siete pasos produce resultados consistentes entre sesiones. Uno sin él produce lo que al modelo le apetezca ese día.
Los Agents investigan, ejecutan, prueban e informan. Las personas marcan la dirección, conceden autoridad y aceptan el resultado.
Preguntas frecuentes
¿Funciona agency-agents con herramientas distintas de Claude Code? Sí. Un script de conversión genera archivos de integración para cada herramienta, y install.sh --tool apunta a una en concreto. Entre los destinos compatibles están Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Copilot, Windsurf, Aider y Kimi Code. También hay una aplicación de escritorio para macOS, Linux y Windows.
¿Debería instalar los 300 roles? No. En OpenCode no puedes, porque se registran unos 119 y el resto se descarta sin avisar. En otras herramientas puedes hacerlo, pero no usarás la mayoría. Instala por divisiones.
¿Hacen los roles que un agente sea más capaz? Hacen que esté mejor dirigido. Mejoran la consistencia y el formato de salida. El conocimiento de hechos que el modelo nunca tuvo no cambia.
¿Es lo mismo que un framework de agentes? No. Un framework te ofrece orquestación de runtime en código. agency-agents te ofrece archivos markdown que cambian el comportamiento de un agente existente. Son capas distintas y no se solapan.
¿Qué relación tiene esto con los Sharkly Skills? Un Skill es una capacidad que adjuntas a la configuración de un Agent, de modo que se reutiliza con ese Agent en lugar de reinstalarse en cada máquina. Las definiciones de roles de este repositorio son una buena materia prima para escribirlos.
La versión corta
agency-agents es la mejor versión disponible de una idea: un agente trabaja mejor cuando sabe qué papel desempeña. Instala una división, lee los archivos y edítalos hasta que encajen con tu equipo.
Después, ten claro dónde está el límite. Los roles no conocen hechos que tu modelo nunca recibió y no persisten en nada que un equipo pueda ver o revisar. Una plantilla es un buen punto de partida, pero no es una organización. Sharkly cubre la otra mitad: la Task es el registro compartido, la ejecución se realiza en Computers que conectas a través de los runtimes que ya pagas, y los resultados vuelven a un lugar donde una persona puede revisarlos y aceptarlos.
