/skills
Las convenciones que sigo, empaquetadas como skills en Markdown para Claude Code, Cursor o cualquier agente que lea instrucciones de un fichero. Cada una es un fichero real, probado en proyectos reales: ábrela, léela entera y llévatela.
Instalación
Una skill es Markdown plano y el agente la carga sola cuando la tarea encaja con su descripción. La vía nativa es la única que se actualiza sola: el marketplace se añade una vez y /plugin marketplace update trae las versiones nuevas.
/plugin marketplace add https://jesusprodriguez.com/skills/marketplace.json
/plugin install azure-devops@jprodriguez-toolkitLa vía nativa, y la única que se actualiza sola: el marketplace se añade una vez y `/plugin marketplace update` trae las versiones nuevas. Las skills quedan con espacio de nombres propio (`azure-devops:azure-pr-review`).
SKILL=azure-pr-review
curl -fsSL https://jesusprodriguez.com/skills/$SKILL/SKILL.md --create-dirs -o .claude/skills/$SKILL/SKILL.mdUn comando en la raíz del proyecto. Claude Code la descubre sola: no hay que registrar nada.
$SKILL = "azure-pr-review"
New-Item -ItemType Directory -Force ".claude/skills/$SKILL" | Out-Null
Invoke-WebRequest "https://jesusprodriguez.com/skills/$SKILL/SKILL.md" -OutFile ".claude/skills/$SKILL/SKILL.md"Un comando en la raíz del proyecto. Claude Code la descubre sola: no hay que registrar nada.
curl -fsSL https://jesusprodriguez.com/skills/install.sh -o install.sh
sh install.sh --allDescarga el script, léelo y ejecútalo. Instala una skill, un stack entero o todas, y arrastra las dependencias entre skills. Con `--check` compara el sha256 de lo que tienes instalado y solo lista lo que cambió.
Ninguna skill coincide con esa búsqueda.
Prueba con un término más corto.
Revisión de PRs, bandeja priorizada, estado de sprint, salud del backlog y planificación en Azure DevOps.
/plugin install azure-devops@jprodriguez-toolkit Automatizar · Azure DevOps
Cimiento de acceso a Azure DevOps: PAT con el ámbito justo, defaults de la CLI, WIQL, OData de Analytics y paginación honesta.
when: Al leer o escribir en Azure Repos, Boards o Pipelines desde la terminal.
Cómo se le pide
Configura el acceso a Azure DevOps en este repo y comprueba que el PAT tiene los ámbitos que hacen falta.
PAT y ámbitos · az devops / az boards · Consultas WIQL · REST y paginación
Revisar · Azure DevOps
Revisar una pull request por criterios de riesgo —correctitud, contrato, seguridad— y dejar los comentarios anclados a la línea que toca.
when: Al revisar una PR concreta o preparar el veredicto antes de aprobar.
Cómo se le pide
Revisa la PR 4821 del repo Expedientes y deja los comentarios anclados en el hilo que toca.
Diff desde refs/pull · Checklist de riesgo · Hilos inline por REST · Bloqueante vs sugerencia
↳ requiere azure-devops-cli
Informar · Azure DevOps
Bandeja de PRs priorizada por quién bloquea a quién: lo que espera tu voto, lo tuyo parado y lo que lleva demasiado abierto.
when: Al empezar el día o al preguntar qué pull requests tienes pendientes.
Cómo se le pide
Dime qué pull requests tengo pendientes esta mañana y cuáles están bloqueando a alguien.
Pendientes de tu voto · Antigüedad y tamaño · Conflictos y builds · Aviso sin ruido
↳ requiere azure-devops-cli
Informar · Azure DevOps
Informe de estado que sirve para decidir: avance frente a lo comprometido, bloqueos, scope entrante y qué no llega.
when: Antes de una daily, una demo o un comité, o al preguntar cómo va el proyecto.
Cómo se le pide
Prepara el estado del sprint actual para la demo del viernes, con lo que no llega marcado.
Sprint por WIQL · Ritmo proyectado · Bloqueos y riesgos · Variante para comité
↳ requiere azure-devops-cli
Auditar · Azure DevOps
Auditoría del backlog con umbrales escritos: sin estimar, sin criterios, parados, bugs sin triar, épicas sin cerrar y zombis.
when: Antes de un refinamiento o como revisión periódica del backlog.
Cómo se le pide
Audita el backlog del proyecto antes del refinamiento del martes y priorízame los avisos.
Siete avisos con umbral · Bugs sin triar · Duplicados candidatos · Aviso con techo
↳ requiere azure-devops-cli
Planificar · Azure DevOps
PBIs que se pueden estimar y cerrar sin discusión: criterios verificables, fuera de alcance explícito y campos completos.
when: Al crear un PBI, un bug o una feature, o al reescribir uno que llega vacío.
Cómo se le pide
Reescribe el PBI 3120: llega sin criterios de aceptación y sin alcance definido.
Criterios de aceptación · Plantilla de bug · Campos obligatorios · Cuándo trocear
↳ requiere azure-devops-cli
Planificar · Azure DevOps
Descomposición de PBIs en tareas de medio día a dos, con dependencias externas señaladas y la pregunta de si el sprint cabe.
when: En la planificación de sprint o al partir un PBI grande en tareas.
Cómo se le pide
Descompón el PBI 3477 en tareas y dime si el sprint cabe con la capacidad que tenemos.
Descomponer por criterios · Spikes con caja de tiempo · Capacidad vs velocidad · Dependencias
↳ requiere azure-devops-cli
Planificar · Azure DevOps
Un PBI convertido en plan anclado al código real, antes de escribir una línea: enfoque razonado, cambios por capa y checklist ejecutable.
when: Antes de implementar algo que toca varias capas, o para validar el enfoque con el equipo.
Cómo se le pide
Planifica el PBI 5104 contra este repositorio y adjunta el plan al work item.
Criterios sin inventar · Rutas de fichero reales · Cambios por capa · Adjuntar al work item
↳ requiere azure-devops-cli
Construir · Azure DevOps
Del ID del work item a un árbol listo para revisar: rama, implementación contra criterios, build y tests, changelog y nota de PR. Sin commitear.
when: Al arrancar un PBI o Bug por su número y llevarlo hasta dejarlo listo para revisar.
Cómo se le pide
Implementa el Bug 5210 y déjalo listo para revisar, sin commitear nada.
Rama desde la base · Plan o modo rápido · Build y test antes de parar · Por qué no commitea
↳ requiere azure-devops-cli
Auditar · Azure DevOps
Foto del código de varios repos a la vez: actividad, dependencias vulnerables, puntos calientes, divergencia y secretos en el historial.
when: Al evaluar el estado del código de un proyecto o decidir dónde invertir mantenimiento.
Cómo se le pide
Haz una foto del estado del código de los repos del proyecto Expedientes.
Inventario y actividad · Vulnerabilidades · Hotspots por churn · Cinco acciones
↳ requiere azure-devops-cli
Automatizar · Azure DevOps
Pipelines YAML que no bloquean al equipo: un artefacto para todos los entornos, plantillas versionadas, secretos fuera del repo.
when: Al crear o modificar azure-pipelines.yml, o cuando una build falla solo en el agente.
Cómo se le pide
Revisa azure-pipelines.yml: la build pasa en local y falla solo en el agente.
Stages y environments · Plantillas y caché · Secretos y aprobaciones · Depurar el agente
APIs REST en .NET 8, caza de bugs de correctitud en C# y verificación contra la documentación oficial de Microsoft.
/plugin install dotnet@jprodriguez-toolkit Construir · .NET Core
Estructura y checklist para una API REST en .NET 8: Minimal APIs por recurso, EF Core sin N+1 y errores en ProblemDetails.
when: Al crear endpoints, modelar entidades con EF Core o depurar consultas lentas.
Cómo se le pide
Monta el endpoint de pedidos en .NET 8 siguiendo la estructura que ya tiene el proyecto.
Minimal APIs · EF Core · ProblemDetails · Configuración y secretos
Búsqueda dirigida de bugs de correctitud en C# y TypeScript: concurrencia, nulos, fechas, transacciones a medias y errores tragados.
when: Al buscar bugs, revisar un módulo sospechoso o entender un fallo intermitente.
Cómo se le pide
Busca bugs de correctitud en el módulo de facturación: hay un importe que sale mal de vez en cuando.
Seguir el dato · Async y concurrencia · Fechas y decimales · Reporte con escenario
Documentar · .NET Core
Verificar contra la documentación oficial antes de escribir código con SDKs de Azure o .NET: que el método existe, que la firma es esa y que el patrón no está obsoleto.
when: Al usar una API de Microsoft por primera vez, o cuando un error no cuadra con lo que esperabas.
Cómo se le pide
Comprueba en la documentación oficial si BlobClient.UploadAsync admite ese overload.
Consultas que acotan · Verificar firmas · Versiones de SDK mezcladas · Patrones obsoletos
Sitios Astro estáticos, landings de negocio local y posicionamiento en la propia ciudad.
/plugin install web@jprodriguez-toolkit Construir · Astro
Convenciones para sitios Astro con salida estática: content collections, imágenes optimizadas e islas solo donde hacen falta.
when: Al crear páginas o componentes .astro, definir colecciones o revisar rendimiento.
Cómo se le pide
Añade una content collection de notas a este sitio Astro, con su página de listado.
Content collections · astro:assets · Islas y client:* · Core Web Vitals
Construir · Conversión
Web de una página para un negocio local: estructura, textos en segunda persona, una sola llamada a la acción y carga rápida en móvil.
when: Al montar la landing de un cliente o revisar por qué una web bonita no trae llamadas.
Cómo se le pide
Monta la landing de una clínica dental en Alcorcón, con un solo formulario de contacto.
Estructura por bloques · Textos y objeciones · Formulario de 3 campos · Legal y entrega
Posicionamiento en la propia ciudad: perfil de empresa, coherencia NAP, JSON-LD de LocalBusiness y páginas por servicio con contenido propio.
when: Al publicar la web de un negocio local o cuando no aparece en las búsquedas de su zona.
Cómo se le pide
Esta web de un taller en Getafe no aparece buscando «taller Getafe»: dime por qué.
Perfil de empresa · Coherencia NAP · LocalBusiness JSON-LD · Qué no hacer
Lo transversal: revisión de PRs en GitHub, recorridos guiados por el código, diagramas editables, automatización en Python, informes en PDF y explicaciones por niveles.
/plugin install ingenieria@jprodriguez-toolkit Revisar · GitHub
Revisar una PR empezando por el radio de impacto —qué más se rompe si esto se rompe— y siguiendo por seguridad, contratos y cobertura.
when: Antes de mergear algo que toca una librería compartida, un contrato de API o el esquema de datos.
Cómo se le pide
Revisa el PR 312: toca la librería compartida y quiero saber qué más se rompe.
Radio de impacto · Barrido de seguridad · Migraciones reversibles · Un test que falle sin el arreglo
Documentar · VS Code
Recorridos guiados que se abren dentro del editor, con cada paso anclado a un fichero y una línea que existen de verdad.
when: Al preparar el onboarding de alguien, explicar una arquitectura o acompañar una PR grande.
Cómo se le pide
Prepara un recorrido de onboarding por la capa de dominio para alguien que entra el lunes.
Un recorrido por persona · Líneas verificadas · Arco narrativo · Qué arruina un recorrido
Documentar · Diagramas
Diagramas generados desde una descripción que salen editables: flujo, arquitectura, secuencia, entidad-relación y carriles por rol.
when: Al explicar un proceso o un sistema con una imagen que después haya que retocar.
Cómo se le pide
Dibuja el flujo de alta de un expediente, desde el formulario hasta la cola de proceso.
Elegir el tipo · Retícula y color · Iconos de marca · Cuándo partir el diagrama
Automatizar · Python
Scripts de automatización que se pueden reejecutar sin miedo: dry-run, logging, códigos de salida honestos e idempotencia.
when: Al escribir CLIs, tareas programadas, tratamiento de ficheros o integraciones con APIs.
Cómo se le pide
Escribe un script que sincronice la carpeta de facturas con el SFTP, con dry-run por defecto.
argparse y dry-run · logging · pathlib y encoding · APIs con timeout
Documentar · Python
Informes en PDF reproducibles con ReportLab: tablas que no se cortan, tipografías embebidas y la misma salida en cada ejecución.
when: Al exportar a PDF un informe de estado, una auditoría o cualquier documento que se envíe fuera.
Cómo se le pide
Exporta este informe de auditoría a PDF con las tablas sin cortarse entre páginas.
Platypus vs canvas · Tablas con repeatRows · Fuentes TTF y acentos · Checklist de envío
Construir · HTML / CSS
Artefactos interactivos autocontenidos al estilo Claude: un HTML con todo inlineado que se abre en el navegador, listo para probar.
when: Al pedir una app rápida, un dashboard, un juego, una visualización o cualquier cosa interactiva para previsualizar.
Cómo se le pide
Crea un artefacto con un juego Snake interactivo con diseño premium.
Apps interactivas · Visualizaciones de datos · Diagramas SVG · Documentos con formato · Diseño premium dark
Documentar · IA aplicada
Explicaciones claras a 4 niveles de profundidad (ELI5 a Experto): analogías que se entienden, diagramas visuales y fuentes verificadas.
when: Al pedir que expliques un concepto complejo, un algoritmo, una arquitectura o un bug a diferentes niveles.
Cómo se le pide
Explícame cómo funciona la autenticación con OAuth2 y JWT en 4 niveles de profundidad, empezando por un ELI5.
4 niveles de profundidad · Analogías y modelos mentales · Diagramas visuales · Fuentes y citas verificadas
El catálogo también se lee sin navegador: el índice trae el sha256 de cada fichero, así que comprobar si algo cambió no obliga a volver a descargarlo.
Ecosistema & Comunidad
Mis skills se centran en Azure DevOps, .NET, arquitectura y flujos de equipo. Para desarrollo con TypeScript, frontend o catálogos abiertos de agentes y comandos para Claude Code, estas son las dos referencias que más recomiendo:
El repositorio de skills más descargado de GitHub. Enfocado en disciplina de ingeniería y dinámicas de prompting (/grill-me, /to-spec, /wayfinder, TypeScript).
Catálogo abierto con más de 1.000 componentes, agentes especializados, comandos y MCPs listos para usar en Claude Code.
Catálogo en construcción: iré publicando más a medida que las depure en proyectos reales. El resto de mi stack está en Herramientas.
De dónde salen
No son plantillas: son las decisiones que tomé revisando PRs de verdad, planificando sprints que había que entregar y depurando builds que solo fallaban en el agente. Si quieres montar este mismo flujo en tu equipo, cuéntame el contexto.
Hablamos