CommunityProgramación y desarrollogithub.com

mattpocock/ask-matt

Pregunta qué skill o flujo se adapta a tu situación. Un enrutador sobre los skills de este repositorio.

¿Qué es ask-matt?

Ask Matt es un skill de enrutamiento diseñado para ayudar a los usuarios a navegar por una colección de skills de agente de IA, principalmente para plataformas como Claude Code, Cursor o Codex. Su función principal es recomendar el flujo o skill más adecuado según la situación actual del usuario, actuando como un punto de partida inteligente. El skill describe una estructura de flujos de trabajo, incluyendo un flujo principal llamado "idea → ship" que guía desde la concepción de una idea hasta su implementación, con ramas para prototipado o construcción multi-sesión. También incluye on-ramps para manejar bugs y solicitudes entrantes, skills de salud del código base, y vocabulario subyacente para modelado de dominio y diseño de código. Ask Matt organiza estos skills en una jerarquía lógica con flujos principales, on-ramps, skills independientes y referencias de vocabulario, facilitando que el agente elija la herramienta correcta sin necesidad de recordar cada skill individualmente. Es útil para equipos que trabajan con agentes de IA y necesitan un sistema organizado para gestionar tareas de desarrollo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/ask-matt

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Pregúntale a Matt

No recuerdas todos los skills, así que pregunta.

Un flujo es un camino a través de los skills. La mayoría de los caminos recorren un flujo principal y dos rampas de acceso se fusionan en él. Todo lo demás es independiente, o una capa de vocabulario que se ejecuta por debajo.

El flujo principal: idea → envío

La ruta que recorre la mayor parte del trabajo. Tienes una idea y quieres que se construya.

  1. /grill-with-docs — afina la idea mediante una entrevista. Comienza aquí cuando tienes un código base: es stateful, reteniendo lo que aprende en CONTEXT.md y ADRs. (¿No hay código base? Usa /grill-me — consulta Independiente. Ambos ejecutan el mismo primitivo /grilling; grill-with-docs es el que deja un rastro documental).

  2. Rama — ¿puedes resolver cada pregunta en conversación? Si una pregunta necesita una respuesta ejecutable (estado, lógica de negocio, una interfaz de usuario que debes ver), desvía a través de un prototipo, puenteado por /handoff en ambas direcciones (consulta Cruzando sesiones):

    • /handoff hacia afuera, luego abre una nueva sesión contra ese archivo,
    • /prototype para responder la pregunta con código desechable,
    • /handoff de vuelta con lo aprendido, y refiérelo desde el hilo de la idea original.
  3. Rama — ¿es esto una construcción de múltiples sesiones?

    • Sí → /to-prd (convierte el hilo en un PRD) → /to-issues (divide el PRD en issues independientemente abordables). Debido a que los issues son independientes, limpia el contexto entre cada uno: inicia una nueva sesión por issue y comienza /implement pasándole el PRD y el único issue en el que trabajar.
    • No → /implement aquí mismo, en la misma ventana de contexto.

    En cualquier caso, /implement construye cada issue manejando /tdd internamente — una rebanada rojo-verde a la vez — luego finaliza ejecutando /code-review, una revisión de dos ejes (Estándares + Especificación) del diff, antes de hacer commit. Recurre a /tdd por sí solo cuando solo quieres construir un comportamiento concreto con pruebas primero sin una especificación completa, y /code-review por sí solo cada vez que quieras revisar una rama o PR contra un punto fijo.

Higiene del contexto

Mantén los pasos 1–3 en una ventana de contexto ininterrumpida — no compactes ni limpies hasta después de /to-issues — para que la entrevista, el PRD y los issues se construyan sobre el mismo pensamiento. Cada /implement luego comienza fresco, trabajando desde el issue.

El límite de esto es la zona inteligente: la ventana (~120k tokens en modelos de última generación) dentro de la cual el modelo aún razona con claridad. Si una sesión se acerca a ella antes de /to-issues, no fuerces en modo degradado — haz /handoff y continúa en un hilo nuevo.

Rampas de acceso

Una situación inicial que genera trabajo y luego se fusiona con el flujo principal.

  • Errores y solicitudes acumulándose → /triage. Mueve los issues a través de roles de triaje y produce issues listos para el agente, que /implement recoge más tarde.

    El triaje es solo para issues que no creaste tú — informes de errores, solicitudes de características entrantes, cualquier cosa que llegue en bruto. Los issues que /to-issues produjo ya están listos para el agente, así que no los triages.

  • Algo está roto → /diagnosing-bugs. Para los difíciles: el error que resiste un primer vistazo, la falla intermitente, la regresión que se coló entre dos estados conocidos como buenos. Se niega a teorizar hasta que tiene un bucle de retroalimentación ajustado — un comando que ya falla con este error — luego corrige con una prueba de regresión. Su análisis post-mortem pasa a /improve-codebase-architecture cuando el hallazgo real es que no hay una buena costura para fijar el error.

Salud del código base

No es trabajo de características — mantenimiento.

  • /improve-codebase-architecture — ejecuta cada vez que tengas un momento libre para mantener el código base en buen estado para que los agentes operen. Descubre oportunidades de profundización; elegir una genera una idea que puedes llevar al flujo principal en /grill-with-docs. Es el estudio que encuentra los candidatos; /codebase-design (abajo) es el banco donde diseñas el elegido.

Vocabulario subyacente

Dos referencias invocadas por el modelo que se ejecutan debajo de los otros skills — cada una es la fuente única de verdad para su vocabulario. Recurre a ellas directamente cuando las palabras, no el proceso, son el problema; o deja que los skills anteriores las incorporen.

  • /domain-modeling — afina el lenguaje de dominio del proyecto: cuestiona un término difuso, resuelve una palabra sobrecargada ("cuenta" haciendo tres trabajos), registra una decisión difícil de revertir como un ADR. Es la disciplina activa que /grill-with-docs impulsa para mantener CONTEXT.md como un glosario limpio.
  • /codebase-design — el vocabulario de módulos profundos (módulo, interfaz, profundidad, costura, adaptador, apalancamiento, localidad) para diseñar la forma de un módulo: mucho comportamiento detrás de una interfaz pequeña en una costura limpia. /tdd y /improve-codebase-architecture ambos lo hablan.

Cruzando sesiones

  • /handoff — cuando un hilo está lleno o necesitas ramificarte (por ejemplo, en una sesión de /prototype), esto compacta la conversación en un archivo markdown. No continúas en el mismo lugar — abres una nueva sesión y haces referencia a ese archivo para llevar el contexto a través. Es el puente entre ventanas de contexto, en cualquier dirección. Úsalo cuando quieras una sesión nueva pero necesites que la conversación actual se conserve.
  • /compact (incorporado) — permanece en la misma conversación, permitiendo que los turnos anteriores sean resumidos. Úsalo en pausas intencionales entre fases, cuando no te importe perder el historial textual. No compactes en medio de una fase — el agente puede perder el rumbo. /handoff bifurca; /compact continúa.

Independiente

Fuera del flujo principal por completo.

  • /grill-me — la misma entrevista implacable que /grill-with-docs, pero para cuando no tienes código base. Sin estado: no guarda nada localmente, no construye CONTEXT.md. Recurre a él para afinar cualquier plan o diseño que no viva en un repositorio.
  • /prototype — un programa pequeño y desechable que responde una pregunta de diseño: ¿este modelo de estado se siente correcto, o cómo debería verse esta interfaz de usuario? Desechable desde el día uno — guarda la respuesta, elimina el código. Es el desvío en el paso 2 del flujo principal, pero recurre a él cada vez que una pregunta de diseño sea difícil de resolver en papel.
  • /research — delega el trabajo de lectura a un agente de fondo: investiga una pregunta contra fuentes primarias, luego deja un archivo Markdown citado en el repositorio. Sigue trabajando mientras él lee. El archivo que produce es algo para llevar hacia el flujo principal en /grill-with-docs — la investigación alimenta el pensamiento, no lo reemplaza.
  • /teach — aprende un concepto a lo largo de múltiples sesiones, usando el directorio actual como un espacio de trabajo con estado.
  • /writing-great-skills — referencia para escribir y editar skills de manera efectiva.

Precondición

/setup-matt-pocock-skills — ejecuta antes de tu primer flujo de ingeniería para configurar el rastreador de issues, etiquetas de triaje y diseño de documentos que los otros skills asumen. Los rastreadores de issues personalizados también funcionan.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

Skills relacionados