skills

Este repositorio es la colección pública de Jon Hill de Agent Skills portátiles: instrucciones autocontenidas, agnósticas del modelo y del harness, que un agente de codificación con IA puede cargar a demanda. Cada habilidad es instalable individualmente y nada es específico de un harness concreto ni depende de herramientas privadas. ## Instalación Explora la colección con `npx skills add jonhill90/skills --list`, o instala habilidades específicas en el proyecto actual con `npx skills add jonhill90/skills --skill tmux --skill github-cli`. La CLI `npx skills` fija las instalaciones por hash de contenido en `skills-lock.json` para garantizar la reproducibilidad. Este repositorio también funciona como plugin de Agent Plugins 1.0.0 (con `plugin.json` en la raíz y las habilidades en `skills/<name>/SKILL.md`), y como plugin de Claude Code mediante `.claude-plugin/`: añade el marketplace con `claude plugin marketplace add jonhill90/skills` e instálalo con `claude plugin install jonhill90-skills@jonhill90`. El plugin no tiene una versión fijada, por lo que sigue el último commit de `main` y carga toda la colección (aproximadamente 5,6k tokens de descripciones de habilidades por sesión). ## Habilidades de esta colección La colección incluye 42 habilidades, cada una con un estado de auditoría de carga (PASS o FAIL) que indica si se detectaron suposiciones sobre la máquina local o la CLI. Algunos ejemplos son: - `ask-a-council` — consultar múltiples perspectivas - `devils-advocate` — cuestionar suposiciones - `failing-test-first` — desarrollo guiado por pruebas - `github-cli` — uso de GitHub CLI - `obsidian` — gestión de notas de Obsidian - `prd` — documentos de requisitos de producto - `spec-driven-development` — desarrollo guiado por especificaciones - `tdd` — desarrollo guiado por pruebas - `tmux` — multiplexor de terminal tmux - y muchas más que cubren flujos de trabajo como planificación, investigación, memoria y eliminación segura. ## Dónde pertenece una habilidad El README aconseja que la mayoría de las habilidades no deberían vivir en este repositorio. La ubicación depende del uso: las habilidades útiles en muchos proyectos no relacionados pertenecen a una colección pública como esta; las habilidades que solo son válidas en un repositorio pertenecen al `.claude/skills/` o `.agents/skills/` de ese repositorio; y las habilidades puntuales o mantenidas externamente pueden usarse directamente mediante `npx skills use <package>@<skill>`. ## Contrato de autoría Cada habilidad vive en `skills/<name>/SKILL.md` con directorios opcionales `scripts/`, `references/` y `assets/`. El frontmatter portátil incluye `name` y `description` (además de `license`, `compatibility`, `metadata` y `allowed-tools` opcionales). El nombre del directorio debe coincidir con `name`, y `SKILL.md` debe mantenerse por debajo de 500 líneas, trasladando el detalle a referencias enlazadas. Las convenciones completas están en `AGENTS.md`. ## Validación Ejecuta `python3 scripts/validate_repository.py` y `python3 -m unittest discover -s tests -v` para validar el repositorio. CI ejecuta ambos en cada pull request y en los pushes a `main`. ## Límites de contenido Este repositorio contiene únicamente contenido de habilidades portátiles y validación/pruebas/CI mínimas. La configuración personal del harness (instrucciones canónicas, hooks, agentes, ajustes, declaraciones MCP, herramientas de instalación/sincronización) vive en un repositorio de harness personal separado. Por ahora no hay aquí un sistema de evaluación de comportamiento; un reemplazo mantenido por la comunidad se sigue en el issue #309. El material propiedad del empleador o específico de un proyecto nunca se copia aquí.