Empezar
Dos caminos que se suman: el plugin, para que Claude Code cargue las skills solo, y la CLI, para que las convenciones vivan en el repositorio y valgan para cualquier asistente.
Instala el plugin en Claude Code
Dentro de Claude Code, añade el marketplace e instala. Después reinicia.
En Cowork: descarga veritas.plugin de la última versión y arrástralo a una conversación.
O escribe las convenciones en el proyecto
Para un proyecto nuevo que ya funciona, o para uno que existe. Lo que queda en el repositorio vale para cualquier asistente que lea AGENTS.md.
npm create veritas@latest my-appnpx create-veritas initMira lo que hay
El menú lista las skills, cómo actualizar y cómo reportar una regla que falló.
/veritas:ajudaMantenlo al día
En la terminal, fuera de Claude Code. O llama /veritas:atualizar y lee el informe.
claude plugin marketplace update veritasclaude plugin update veritas@veritas
Contribuir
- Es markdown: no hace falta programar. Antes de crear algo, busca dónde vive ya la regla y cámbiala ahí.
- Skill nueva: copia docs/modelo-de-skill/ a skills/<nombre>/. La description dice cuándo usarla, con las palabras que usaría un desarrollador.
- El eje es el stack, no el proyecto. Una regla que vale para un solo repositorio va en el CLAUDE.md de ese repositorio.
- Antes del PR, en la carpeta plugin/, ejecuta las pruebas y el validador:
uv run pytestuv run python tools/validate_skills.py skills