owasp/secure-agent-playbookProyecto OWASP de Playbook de Agentes Seguros
Un playbook de seguridad de código abierto para agentes de IA. Procedimientos estructurados y basados en OWASP que permiten a los agentes realizar tareas de ingeniería de seguridad — desde la revisión de código hasta las auditorías de seguridad de agentes de IA.
Sin un playbook, pedirle a un agente de IA que "revise mi código en busca de problemas de seguridad" te da una lista de verificación superficial. Con estos plays, el agente sigue un procedimiento estructurado y basado en OWASP — probando sistemáticamente cada clase de vulnerabilidad, produciendo hallazgos con mapeos a CWE, referencias cruzadas de OpenCRE, fragmentos de evidencia y código de remediación específico.
Esto no es un framework ni una librería. No hay código que importar.
Cada play es un procedimiento de seguridad paso a paso con listas de verificación, criterios de decisión y plantillas de salida. Un agente de IA sigue el procedimiento para producir hallazgos consistentes y basados en evidencia. Piénsalo como el playbook de un analista de SOC — pero escrito para que lo ejecuten agentes de IA.
Con Claude Code (recomendado):
Paso 1 — Registra el marketplace de plugins:
/plugin marketplace add OWASP/secure-agent-playbook
Paso 2 — Instala un conjunto de skills:
/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook
Paso 3 — Usa las skills mencionando la tarea en la conversación:
"Review this code for security issues"
"Scan my dependencies for CVEs"
"Audit this MCP server configuration"
"Test this chatbot for prompt injection"
Claude activará automáticamente la skill relevante según el contexto. Consulta el Catálogo de Skills para ver todas las skills disponibles y Ejemplo de Salida para ver cómo son los resultados.
Plugin de organización — Para administradores de organizaciones de Claude que instalan mediante Organization Plugins:
secure-agent-playbook.zip desde los assets de la versiónNota: No uses el botón "Download ZIP" de GitHub — anida los archivos en un subdirectorio que el validador de plugins rechaza. Usa siempre el zip de los assets de la versión.
Skills de organización — Para administradores de organizaciones de Claude que suben skills individuales en Organization settings > Skills:
web-security-review.zip)Nota: La carga de skills rechaza los zips con más de 200 archivos, por lo que el
secure-agent-playbook.zipcompleto no se puede subir ahí — usa los zips por skill. Para generarlos desde un clon, ejecutascripts/package_skills.shy sube desdedist/skills/.
Desarrollo local — Para probar desde un clon local en lugar de GitHub:
/plugin marketplace add /path/to/agent-security-playbook
/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook
Sin Claude Code:
Consulta los plays directamente como procedimientos para cualquier agente de IA o uso manual:
plugins/ai-security-skills/plays/agent-security-audit.md"code-security-skills)| Skill | Qué Hace | Di Esto | Ref OWASP |
|---|---|---|---|
code-review-security | Revisión de seguridad de código mapeada a Top 10 + ASVS | "Review this code for security issues" | Top 10, ASVS |
sca-audit | Escaneo de CVE en dependencias con análisis de alcanzabilidad | "Scan my dependencies for CVEs" | A06:2021 |
secrets-scan | Detección de credenciales y claves de API codificadas de forma fija | "Scan for hardcoded secrets" | CWE-798 |
api-security-review | Revisión de API contra OWASP API Top 10 (2023) | "Review this API for security" | API Top 10 |
web-security-review | Revisión de aplicación web contra OWASP Top 10 (2021) | "Review this web app for OWASP Top 10" | Top 10 |
mobile-code-review | Revisión de código fuente nativo Android/iOS contra OWASP MASVS v2.1.0 | "Review this mobile app for security" | MASVS v2.1.0 |
iac-security-review | Seguridad de IaC (Terraform, K8s, CloudFormation) | "Review this Terraform for security" | CIS Benchmarks |
securability-engineering | Genera código inherentemente asegurable (FIASSE v1.0.4) | "Generate secure code for..." | FIASSE v1.0.4 |
securability-engineering-review | Evalúa la asegurabilidad del código (puntuación SSEM 0-10) | "Assess the securability of this code" | FIASSE v1.0.4/SSEM |
prd-securability-enhancement | Refuerza PRDs/especificaciones con cobertura ASVS y requisitos FIASSE SSEM antes de escribir el código | "Harden this PRD" / "Map features to ASVS" | ASVS, FIASSE v1.0.4 |
security-guidance | Guía ASVS autoactivada para código sensible a la seguridad | (autoactivada) | ASVS 5.0 |
ai-security-skills)| Skill | Qué Hace | Di Esto | Ref OWASP |
|---|---|---|---|
agent-security-audit | Audita permisos de agentes, superficies de inyección, rutas de exfiltración de datos | "Audit this agent's security" | LLM Top 10 |
llm-risk-assess | Evaluación de aplicaciones LLM contra LLM Top 10 2025 | "Assess LLM risks for this app" | LLM Top 10 |
agentic-ai-risk-assess | Evaluación de aplicaciones agénticas contra Top 10 Agentic 2026 | "Assess agentic AI risks" | Agentic Top 10 |
mcp-server-review | Revisión de seguridad de servidores MCP | "Review this MCP server" | LLM Top 10 |
prompt-injection-test | Pruebas de inyección de prompts (Arcanum PI Taxonomy) | "Test for prompt injection" | LLM01 |
multi-agentic-threat-model | Modelado de amenazas CSA MAESTRO de 7 capas | "Model threats for this multi-agent system" | CSA MAESTRO |
ai-security-verification | Verificación de aplicaciones de IA contra OWASP AISVS (13 categorías) | "Verify this AI app against AISVS" | AISVS |