Crear una skill — Docs AKOS

Ejemplo

skills/scan-secrets/skill.md

---
slug: scan-secrets
input:
  path: string
output:
  findings: SecretFinding[]
errors:
  - INVALID_PATH
  - IO_ERROR
version: 1.9.0
---

## Procedimiento
1. Recorrer archivos versionados en `path`.
2. Aplicar detectores deterministas por tipo (AWS, GCP, tokens genéricos).
3. Redactar el hallazgo antes de emitirlo.
4. Devolver `findings` con severidad y ubicación.

## No hace
- No abre red.
- No escribe en disco.
- No usa modelos.

Buenas prácticas

· Entradas y salidas tipadas explícitamente.
· Errores enumerados; nada de "algo falló".
· Sin efectos de red o disco salvo declaración.
· Idempotente cuando sea posible.