La habilidad /ask-matt

Fuente: The /ask-matt Skill — traducción comunitaria no oficial al español.

Qué hace

ask-matt es el enrutador sobre las habilidades de este repo. Describes la situación en la que estás (una idea que no logras empezar, una pila de informes de errores entrantes, una sesión que se ha alargado), y nombra la habilidad o la secuencia de habilidades que encaja, además de dónde están las decisiones humanas en esa secuencia.

Recomienda y se detiene. No interroga, no escribe una spec, no abre un archivo ni dispara la habilidad que acaba de nombrar; lo que recibes es lo siguiente que debes escribir, y lo escribes tú. También es un mapa escrito a mano de las habilidades de este repo y no un análisis de lo que tienes instalado, así que no te enrutará hacia tus propias habilidades ni las de otro autor.

Cuándo usarla

La invocas escribiendo /ask-matt; el agente no la usará por su cuenta.

Tu situación	Lo que devuelve el enrutador
Una idea, y ninguna idea de por dónde empezar	El inicio del flujo principal, y si la construcción es lo bastante pequeña para omitir la spec
Errores y solicitudes que llegan de otras personas	La rampa de entrada de triaje, y por qué los tickets que generaste tú no pertenecen a ella
Dos habilidades que parecen intercambiables	La línea que las separa, y suele ser una prueba concreta más que una cuestión de gusto. grill-me o grill-with-docs depende de si estás en un directorio de trabajo; grill-with-docs o wayfinder depende de si el esfuerzo cabe en una sesión
Una sesión larga y una decisión sobre el contexto	El árbol ordenado sobre las cinco opciones en un límite de fase
Una habilidad que ya elegiste	Nada útil. Invoca esa habilidad directamente.

Requisitos previos

El enrutador nombra habilidades; no las instala. Todo a lo que apunta tiene que estar instalado para que la recomendación sea accionable, y solo conoce las habilidades promovidas de este repo.

Las rutas que dependen del gestor de pendientes (triaje, to-spec, to-tickets, implement) suponen que setup-matt-pocock-skills ya configuró un gestor de pendientes (issue tracker) en el repo. El enrutador las recomendará igual aunque eso aún no haya ocurrido.

Flujos, no habilidades

La palabra que la habilidad te da para pensar es flujo: un camino a través de las habilidades, no una sola. Nombrar tu situación te coloca en un flujo en un paso, que es una respuesta distinta de «aquí está la habilidad que coincide con tus palabras clave». Existen cuatro tipos de ruta, y la habilidad misma las contiene en su totalidad:

• El flujo principal, de la idea a publicar. Interrogatorio, spec, tickets, implement, review, con dos ramificaciones dentro: un desvío de prototipo cuando una pregunta necesita código ejecutable para resolverse, y la división entre spec y tickets, que solo compensa su costo cuando la construcción abarca más de una sesión.
• Rampas de entrada, para una situación que genera trabajo y luego se incorpora al flujo principal: informes de errores entrantes, algo roto, o un esfuerzo demasiado difuso y demasiado grande para caber en una sesión.
• Independientes, fuera de todo flujo, que se usan por sí mismas: el prototipo, el cuestionario, el conflicto de merge en el que ya estás metido.
• Una capa de vocabulario por debajo, las dos referencias que las demás habilidades consultan cuando el problema son las palabras y no el proceso.

El límite de fase

La otra idea que te entrega es el límite de fase. Una fase es un bloque de trabajo dentro de una sesión (el interrogatorio, la implementación, el QA), y el límite entre dos de ellas es el único lugar al que pertenece la pregunta «¿qué hago con este contexto?». A mitad de fase no hay nada que decidir: continúa, o divide lo que queda en subagentes.

Opción	Tómala cuando
Continue	La siguiente fase quiere esta tal cual, o te queda smart zone. Es el único movimiento que mantiene la sesión como fuente primaria, así que descártalo primero
/clear	Todo lo que quedó atrás es desechable. El movimiento más barato del tablero, y unidireccional si te equivocaste
handoff	Algo tiene que viajar: un harness nuevo, un directorio nuevo, un colega, una subtarea bifurcada a mitad de fase
Subagente	La tarea está lo bastante acotada para ejecutarse contigo lejos del teclado
/compact	Ninguna de las anteriores. El valor por defecto, y se cae aquí a menudo

Dos de ellas se entienden mal de forma rutinaria, por eso el enrutador lleva el orden y no solo la lista. /handoff parece el puente general entre ventanas y no lo es: la portabilidad es todo lo que compra. /compact es el fondo del árbol y no el primer recurso, porque las cuatro preguntas que están encima son cada una más barata o más precisa.

Preguntas frecuentes

¿No hay simplemente una lista de las habilidades en el orden correcto?

La gente no deja de pedir una en el README. Esta habilidad es esa lista: existe para eso. Una tabla estática diría wayfinder → to-spec → to-tickets → implement → code-review y estaría equivocada para la mayoría de las situaciones, porque lo interesante son las ramificaciones: si hay una base de código, si la construcción abarca sesiones, si esta pregunta se puede resolver hablando. El costo honesto es que el enrutador se mantiene a mano y va por detrás del repo. /grilling y /resolving-merge-conflicts se publicaron mucho antes de que el enrutador las nombrara.

Me dijo que la mitad de las habilidades no están instaladas.

Un error conocido, sin corregir. La mayoría de las habilidades por las que el enrutador te guía tienen disable-model-invocation: true, lo que significa que el harness las deja fuera de la lista de habilidades que inyecta en el contexto del agente. El agente lee esa lista como exhaustiva e informa que faltan. En una sesión reportada declaró ausente todo el flujo de spec y tickets y redirigió a /grilling y /tdd sin más. Trece de las veintidós habilidades del plugin llevan esa marca, así que este es el caso común y no un borde. Están instaladas. Escribe el comando con barra de todos modos, o revisa .claude-plugin/plugin.json, que es la autoridad sobre lo que está presente.

Describió el comportamiento de una habilidad, y la habilidad no hace eso.

También real, también sin corregir. El enrutador responde desde su propio resumen de una línea de cada habilidad y no desde la habilidad. Un informe detallado rastreó tres casos en una sola sesión, incluida una recomendación de omitir to-spec basada en la glosa «convierte el hilo en una spec»: to-spec/SKILL.md nunca se abrió. En todos los casos solo verificó después de que el usuario insistiera, y nunca por iniciativa propia. Omitir to-spec ahí costó una verificación real de costuras, y los tickets resultantes subestimaron el trabajo. Cuando el enrutador afirme algo determinante sobre otra habilidad, pídele que abra ese SKILL.md primero. Lo mismo vale para preguntas que el mapa no cubre en absoluto, como si usar el modo plan: esa respuesta es la inferencia del modelo, no algo escrito aquí.

¿Por qué es prosa en vez de una lista numerada?

Una queja justa, presentada como un issue abierto que sostiene que la mayor parte del enrutamiento es determinista y que la narrativa dificulta el escaneo. Nada te impide pedir la forma comprimida: «solo dame la secuencia» te da la secuencia. Lo que la prosa sostiene es la mitad condicional: las ramificaciones, dónde se espera una decisión humana, y dónde limpiar o compactar entre pasos. Una lista plana pierde exactamente eso.

¿Puede enrutar sobre mis propias habilidades, o las de otro autor?

No. Tres propuestas distintas han pedido un enrutador que lea tu directorio local skills/ y recomiende desde lo que esté instalado. ask-matt no es eso. Es un mapa de un conjunto, mantenido a mano, y no sabe nada de las habilidades que escribiste o instalaste desde otro lugar.

Me dijo que editara un SKILL.md.

Ese consejo suele ser correcto y rara vez durable. Alguien preguntó cómo hacer que implement cerrara tickets, le dijeron que añadiera una línea a la habilidad, e inmediatamente vio el problema: npx skills update sobrescribe el archivo, y la instalación del plugin es de solo lectura. Pon el comportamiento permanente en tu propio CLAUDE.md o AGENTS.md, o dilo en la invocación. Las adaptaciones a nivel de prompt sobreviven a las actualizaciones: apuntar el flujo a Linear en vez de GitHub, o preguntarle qué tickets abiertos podrían correr en paralelo, son cosas que la gente hace así.

Nombró una habilidad que no tengo, o pasó por alto una que sí tengo.

Revisa el changelog por un renombre antes de suponer que desapareció. writing-great-skills se convirtió en writing-for-agents sin alias, to-prd se convirtió en to-spec, y pathfinder se convirtió en wayfinder. Cuatro habilidades se retiraron por completo hacia las habilidades que las absorbieron: ubiquitous-language, design-an-interface, qa y request-refactor-plan. El caso inverso es el propio retraso del enrutador, más arriba.

Funciona si

• Termina nombrando qué escribir y se detiene ahí, en vez de empezar el trabajo mismo.
• La ruta que devuelve menciona dónde limpiar o compactar el contexto y dónde se espera que revises, no solo una lista de nombres de habilidades.
• Donde dos habilidades están cerca, dice cuál y por qué la otra no es para ti.
• Cualquier afirmación que haga sobre el comportamiento de otra habilidad aparece en la traza como lectura del SKILL.md de esa habilidad.
• Reconoces tu propia situación en lo que te entrega, en vez del escenario genérico más cercano.

Dónde encaja

ask-matt es un enrutador independiente que está sobre todo el conjunto. Nunca es un paso en una cadena; apunta a cada cadena, y es el nodo al que las demás páginas de docs enlazan de vuelta para que ninguna tenga que redibujar el grafo. Desde aquí lo más común es aterrizar en grill-with-docs, el inicio del flujo principal, o triage, la rampa de entrada para el trabajo que llegó en vez del trabajo que empezaste.

Es una fuente secundaria sobre las habilidades que describe. Donde el enrutador y un SKILL.md discrepen, el SKILL.md tiene razón.