Skip to content
Back to skills

Appsec Report

ASecurity

Tribunal de validación y entrega del informe de seguridad: revisa si el framework, ORM o middleware ya mitiga cada hallazgo, asigna confianza de 1 a 10 y descarta los falsos positivos que no llegan a 7, calcula la nota A-F y redacta el informe final con resumen ejecutivo, vector y parches en diff. Úsala cuando haya que filtrar falsos positivos de una auditoría, puntuar hallazgos, calificar la seguridad de un proyecto o preparar el informe para dirección y para el equipo técnico. English: vali...

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgobashvuegit

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill appsec-report --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Appsec Report?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Appsec Report
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-appsec-report/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-appsec-report)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: appsec-report
description: >
  Tribunal de validación y entrega del informe de seguridad: revisa si el
  framework, ORM o middleware ya mitiga cada hallazgo, asigna confianza de 1 a
  10 y descarta los falsos positivos que no llegan a 7, calcula la nota A-F y
  redacta el informe final con resumen ejecutivo, vector y parches en diff.
  Úsala cuando haya que filtrar falsos positivos de una auditoría, puntuar
  hallazgos, calificar la seguridad de un proyecto o preparar el informe para
  dirección y para el equipo técnico.
  English: validate findings against framework mitigations, score confidence,
  discard noise, grade the project A-F and produce the executive and technical
  report with diff patches.
license: MIT
metadata:
  package: appsec-audit
  version: "1.4.0"
---

# AppSec · Tribunal y informe

Un informe con veinte hallazgos de los que doce son ruido es peor que un informe con cinco correctos: consume el tiempo del equipo y quema la credibilidad del revisor.

## Precondiciones

- Candidatos de `appsec-code`, `appsec-infra` y `appsec-llm`, cada uno con evidencia.
- Acceso al código y la configuración para verificar mitigaciones.

## El tribunal

Para cada candidato, responder por escrito:

1. **¿Es alcanzable?** Existe una ruta real desde una entrada controlable hasta el sumidero.
2. **¿Hay mitigación?** Framework, ORM con parámetros, autoescape, middleware, validación en el borde, permiso comprobado en servidor.
3. **¿La configuración aplica en producción?** Un `debug` activo en local no es un hallazgo de producción; uno activo por defecto en el despliegue, sí.
4. **¿Es explotable por quién?** Anónimo, usuario autenticado, otro inquilino, insider.
5. **¿Qué evidencia lo sostiene?** `ruta:línea`, comando y salida, o la ausencia documentada de control.

Confianza **1–10**:

| Valor | Significado |
|---|---|
| 9–10 | Ruta completa verificada y mitigación ausente comprobada |
| 7–8 | Ruta verificada con una duda menor documentada |
| 4–6 | Indicio sólido sin ruta completa |
| 1–3 | Sospecha por patrón |

**Por debajo de 7 se descarta.** No se incluye «por si acaso»: se anota en el registro de descartes con el motivo, que el informe resume en una línea.

## Severidad y nota

Severidad por impacto y explotabilidad reales, no por tipo de CWE. La nota global sale de los hallazgos validados:

| Nota | Criterio |
|---|---|
| A | Sin críticos ni altos; como mucho medios aislados |
| B | Sin críticos; algún alto mitigable a corto plazo |
| C | Un crítico o varios altos |
| D | Varios críticos o un crítico con datos expuestos |
| F | Crítico explotable sin autenticación o compromiso en curso |

`scripts/grade.py` aplica la fórmula de forma determinista: descuenta 25 por crítico, 10 por alto, 3 por medio y 1 por bajo, con suelo en 0, y traduce la puntuación a letra. Los hallazgos descartados no puntúan.

## Informe

Rellenar `templates/report.md` y escribir los hallazgos en `findings.json` (esquema en `../schemas/findings.schema.json`):

- **Resumen ejecutivo** en lenguaje de negocio: qué se puede perder y qué hacer primero, en cinco líneas.
- **Tabla de hallazgos** ordenada por severidad, con `CWE`, `OWASP`, confianza y ubicación.
- **Detalle por hallazgo**: descripción, impacto, vector paso a paso, evidencia y parche en `diff` (antes y después).
- **Descartes**: cuántos y por qué, en una línea.
- **Límites**: qué no se pudo revisar y con qué consecuencia.

## Verificación independiente

Un tribunal que se autoconfirma no es un tribunal. Cada candidato pasa a un verificador nuevo con `../templates/verification.md`, que recibe solo ubicación, CWE, patrón observado y propósito declarado: sin evidencia, veredicto, confianza ni parche. Responde las cinco preguntas de refutación y devuelve el veredicto con la comprobación que lo sostiene; `exploit` y `patch` los completa quien reporta.

## Entrega en CI

```bash
py appsec-audit/scripts/export_sarif.py <dir>/.appsec-audit/findings.json --output appsec.sarif
py appsec-audit/scripts/diff_reports.py baseline.json <dir>/.appsec-audit/findings.json --fail-on new
```

SARIF lleva los hallazgos `confirmed` a GitHub Code Scanning; `--include-pending` añade los `needs_validation` como `note` y los `rejected` nunca salen. El baseline compara por fingerprint contra la pasada anterior y `--fail-on new` bloquea el PR cuando aparece un `confirmed` que antes no estaba.

## Gate de salida

- Ningún hallazgo por debajo de 7 en el informe.
- Cada uno con evidencia verificable y confianza declarada.
- Nota calculada con el script, no a ojo.
- Resumen ejecutivo comprensible sin leer el detalle técnico.
- Parches en diff aplicables, sin cambios de estilo.
- `findings.json` pasa `validate_findings.py`: sin severidad fuera de `confirmed` y sin unidades `planned` en el ledger.
- Cada hallazgo lo revisó un verificador que no vio el informe previo.
- En destino PR, SARIF y diff contra el baseline generados.

## Handoff

Entrega el informe al propietario del sistema y, si procede, al equipo que implementa. Los parches se aplican solo con petición explícita; el revisor no toca el código por iniciativa propia. Si aparece un crítico explotable, se avisa antes de terminar el informe.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.