Tarjeta de Sistema Agéntico (Documenta tu agente IA)
Montaste un agente y funciona. Lo que no has creado todavía es el documento que explica qué hace, a qué tiene acceso, quién responde si se equivoca y cómo se apaga.
Esta herramienta construye ese documento contigo, sección por sección, siguiendo la plantilla oficial de IAméricas y Adigital. Son trece secciones que van desde el propósito del sistema hasta el inventario completo de componentes. El objetivo está en la propia plantilla. Si mañana hay un incidente o una auditoría, cualquier persona razonable tiene que poder reconstruir qué era el sistema, qué podía hacer, qué controles tenía y quién asumía la responsabilidad.
Se adapta a lo que ya sabes. Si vuelcas un documento técnico, la skill lo lee y rellena lo que pueda antes de preguntarte nada. Si dudas en un campo, te explica qué significa, por qué importa y te descompone la pregunta en algo más fácil de responder.
Empieza con dos preguntas que deciden cómo se organiza todo: (1) ¿es un único agente, o son varios coordinándose?, y (2) cómo se llama el sistema.
Luego avanza sección por sección. Puedes parar cuando quieras y retomarlo después. Nunca te pide contraseñas, tokens ni secretos reales.
Tampoco te recomienda marcas. Si no sabes qué herramienta usar para una pieza, te ayuda a definir qué tiene que cumplir esa pieza. Si quieres comparar opciones reales, te deriva al Evaluador de Proveedores.
¿Qué produce?
Un Word y un PDF con el informe.
Identidad y propósito del sistema, responsables y control de cambios.
Nivel de autonomía, memoria y límites de acción.
Herramientas, permisos y superficie de acción, es decir, todo lo que el agente puede tocar.
Arquitectura interna, topología multiagente si aplica, modelo base y fuentes de conocimiento.
Evaluación y pruebas, supervisión humana, seguridad, privacidad y cumplimiento operativo.
Plan de incidentes y de vuelta atrás.
El inventario de componentes del agente y los anexos de evidencia.
Un resumen inicial con el recuento de huecos pendientes y cuáles caen en secciones críticas.
Cuándo usarla
Antes de poner un agente en producción.
Un cliente grande o una licitación te pide documentación de gobernanza.
Quieres que el conocimiento del sistema no resida solo en la cabeza de una persona.
Después de un incidente, para dejar constancia de qué había y qué cambió.
Cambias algo material del agente, como su autonomía, sus permisos o sus datos, y toca subir la versión.
Qué necesitas antes
Qué hace el agente y para quién.
Quién es responsable de él dentro de tu empresa.
A qué sistemas y a qué datos accede, y con qué permisos.
Qué puede hacer sin pedir permiso y qué no puede hacer nunca.
Qué modelo de IA usa por debajo y si lo ajustaron de alguna forma.
Cómo lo probaron antes de ponerlo a funcionar.
Quién revisa su trabajo y qué harían si falla o hay que apagarlo.
Lo que no sepas queda marcado como pendiente de definir, a la vista y agrupado al final, nunca escondido dentro de un documento aparentemente completo.
Dónde funciona y cómo instalarla
Elige tu plataforma y sigue los pasos. En las que llevan la etiqueta “Nativo” el archivo se instala tal cual; en ChatGPT y Gemini todavía no se instala, y ahí se pega el contenido del SKILL.md en el chat.
Método A — Subir el archivo (el más fácil)
1Descarga el archivo con el botón de arriba. No hace falta descomprimirlo.
2Abre Claude —la aplicación de escritorio en Windows o Mac, o claude.ai— y ve a Personalizar → Skills.
3Haz clic en “Agregar” y sube el archivo tal cual. Si el formulario no lo acepta por la extensión, cámbiale el .skill por .zip y vuelve a subirlo: es el mismo archivo.
4La skill aparece en tu lista de capacidades, lista para activar.
Ya está instalada. Actívala desde el panel de capacidades, o escribe @ seguido de su nombre dentro de cualquier conversación.
Método A — Dejar la carpeta en su sitio
1Descarga el archivo con el botón de arriba.
2Descomprímelo: clic derecho sobre él → “Abrir con” → WinRAR, 7-Zip o el descompresor que uses. Es un ZIP por dentro, así que lo abren sin problema aunque la extensión sea .skill.
3Te queda una carpeta con el nombre de la skill. No la renombres.
4Muévela entera dentro de esta ruta. Si no existe, créala:
Windows
C:\Users\TU-USUARIO\.claude\skills
macOS y Linux
/Users/TU-USUARIO/.claude/skills
En Windows, TU-USUARIO es el nombre de tu cuenta. Pega la ruta en la barra de direcciones del Explorador y te lleva ahí.
Ya está instalada. Escribe /iamericas-tarjeta-sistema-agentico, o describe tu caso y Claude la carga sola cuando encaja.
Método A — Doble clic (el más fácil)
1Descarga el archivo con el botón de arriba.
2Haz doble clic en el archivo descargado. Codex se abre y te pide confirmación para instalarlo.
3Si no se abre solo, haz clic derecho sobre el archivo → “Abrir con” → Codex.
Método B — Mover la carpeta a mano
1Descarga el archivo con el botón de arriba.
2Descomprímelo: clic derecho sobre él → “Abrir con” → WinRAR, 7-Zip o el descompresor que uses. Es un ZIP por dentro, así que lo abren sin problema aunque la extensión sea .skill.
3Te queda una carpeta con el nombre de la skill. No la renombres.
4Muévela entera dentro de esta ruta. Si no existe, créala:
Windows
C:\Users\TU-USUARIO\.agents\skills
macOS y Linux
/Users/TU-USUARIO/.agents/skills
En Windows, TU-USUARIO es el nombre de tu cuenta. Pega la ruta en la barra de direcciones del Explorador y te lleva ahí.
Ya está instalada. Reinicia Codex si estaba abierto. Después escribe $iamericas-tarjeta-sistema-agentico, o /skills para verlas todas.
Método A — Pegar las instrucciones en el chat
1Descarga el archivo con el botón de arriba.
2Descomprímelo: clic derecho → “Abrir con” → WinRAR, 7-Zip o el descompresor que uses.
3Dentro de la carpeta, abre el archivo SKILL.md con el Bloc de notas o cualquier editor de texto.
4Copia todo su contenido y pégalo al principio de una conversación nueva. A partir de ahí, ChatGPT sigue esas instrucciones.
Los scripts que calculan puntuaciones no se ejecutan por esta vía, así que los resultados numéricos los estima el modelo. Si necesitas el cálculo exacto, úsala en Codex o en Claude.
Método A — Pegar las instrucciones en el chat
1Descarga el archivo con el botón de arriba.
2Descomprímelo: clic derecho → “Abrir con” → WinRAR, 7-Zip o el descompresor que uses.
3Dentro de la carpeta, abre el archivo SKILL.md con el Bloc de notas o cualquier editor de texto.
4Copia todo su contenido y pégalo al principio de una conversación nueva. A partir de ahí, Gemini sigue esas instrucciones.
Los scripts que calculan puntuaciones no se ejecutan por esta vía, así que los resultados numéricos los estima el modelo. Si necesitas el cálculo exacto, úsala en Codex o en Claude.
Método A — Mover la carpeta
1Descarga el archivo con el botón de arriba.
2Descomprímelo: clic derecho sobre él → “Abrir con” → WinRAR, 7-Zip o el descompresor que uses. Es un ZIP por dentro, así que lo abren sin problema aunque la extensión sea .skill.
3Te queda una carpeta con el nombre de la skill. No la renombres.
4Muévela entera dentro de esta ruta. Si no existe, créala:
Windows
C:\Users\TU-USUARIO\.copilot\skills
macOS y Linux
/Users/TU-USUARIO/.copilot/skills
En Windows, TU-USUARIO es el nombre de tu cuenta. Pega la ruta en la barra de direcciones del Explorador y te lleva ahí.
Ya está instalada. Escribe / en el chat y elígela del menú. Para compartirla con tu equipo, ponla en .github/skills/ dentro del repositorio.
Historial de versiones
v1.2
21 de septiembre de 2026 · 1,3 MB
Cambia cómo arranca la conversación. Si el primer mensaje no trae contexto, la skill explica antes de preguntar nada cómo funciona el proceso: las fases, que se puede parar y retomar, y qué se recibe al final; y avisa de que los datos valen escritos o adjuntos en un archivo. Si el contexto ya viene, lo confirma en dos líneas y arranca sin soltar esa explicación. La descripción se reescribe para decir que es un proceso guiado paso a paso.
v1.1
14 de septiembre de 2026 · 1,3 MB
Español neutro en todos los textos. Averigua qué intérprete de Python hay en el sistema, fija desde qué carpeta se ejecuta el validador de la tarjeta, avisa si falta la dependencia del documento en Word, y `--help` deja de tratarse como si fuera el nombre de un archivo.
¿Nunca has creado un agente? ¿Quieres hacerlo de forma segura y responsable? Convierte una tarea que lleva horas en el diseño completo de un agente de IA, enriqueciendo tu idea con escalones, barandillas de seguridad, etc.