Escribe el tutorial de la tarea

El how-to público de una tarea. Enseña a hacer, mientras el artículo de concepto enseña a entender: no se canibalizan. Y protege el sujeto continuo sin perder autoridad — porque la autoridad no viene de los pasos, viene de la vivencia que los rodea.

Fuente única

• Anatomía de la nota de tarea y su artículo → Lineamientos, «Anatomía de las notas».
• Contrato de los huecos y el gate → Lineamientos, «Gate de experiencia (la aduana)» (los huecos van por clase de nota y momento; el de esta clase es el de build).
• Los tres pisos y la protección del sujeto continuo → Prompt Maestro, «El embudo del curso emergente».
• Doble CTA y su resolución → DD-05: url_producto → url_lead_magnet → url_newsletter, leído del frontmatter de la ruta. url_newsletter existe siempre.
• Voz → Lineamientos, «Voz (por defecto del motor)», especializada por el Norte.
• Capa técnica → references/capa-tecnica-tutorial.md.

⚙️ Runtime

Claude Code sobre el vault. Escribes texto; no publicas, no subes nada. Una pieza por turno.

Qué hace y qué NO hace

Sí: decide la intención de búsqueda del how-to · redacta el artículo completo (capa humana) con pasos genéricos y verificables · deja los huecos de experiencia en su sitio exacto · resuelve el doble CTA leyéndolo del frontmatter de la ruta · emite la 📦 CAPA TÉCNICA al final · declara el gate (publicable: no mientras haya huecos).

No: no ejecuta la tarea ni inventa que la ejecutó · no rellena los huecos · no enseña paso a paso sobre el sujeto continuo del proyecto · no re-explica los conceptos (se enlazan: su nota es la fuente única) · no inventa URLs, cifras, versiones ni fuentes · no crea la nota ni toca la ruta · no produce guion de video (el video tutorial atómico murió en v2.12).

🎓 El skill explicado al viajero (las 17 preguntas)

🧭 En el viaje: el manual del oficio. De cada jornada de obra sale una receta pública que cualquiera puede seguir con su propia pieza de práctica — el oficio se enseña, los planos de la obra propia no se regalan — y trae, contada por el viajero, la historia de lo que se rompió al hacerla de verdad. Es el piso gratis del embudo: por estas recetas llega la gente que ningún pregón alcanzaría.

Esta sección no es doctrina de ejecución: es el mapa para que cualquier persona —incluido quien llega al motor con 37 skills delante y ninguno vivido— sepa qué es esto, cuándo le toca y cómo saber si lo está usando bien.

1 · ¿Cuándo corre? Casi siempre como sub-rutina: crea-nota-tarea lo invoca al montar la nota — ANTES de que el viajero ejecute (por eso deja huecos, no experiencia). Suelto (DD-02), sobre una nota de tarea existente cuya sección de artículo esté vacía.

2 · ¿Por qué existe? Porque el how-to es el piso GRATIS escrito del embudo (v2.12): el long-tail (cola larga) que atrae por búsqueda procedimental («cómo hacer X») a gente que ningún otro canal traería. Y porque ese artículo necesita nacer con la craft más delicada del embudo ya resuelta: enseñar sin regalar.

3 · ¿Cómo lo hace? Fija la consulta procedimental real (el H1 habla el idioma de quien busca, no el nombre interno de la tarea), redacta el how-to completo (respuesta-primero, prerrequisitos enlazados, pasos numerados con su señal de éxito, validación, errores comunes con síntoma literal, FAQ, doble CTA leído de la ruta) y emite la capa técnica con schema HowTo + Article. Deja el hueco de build donde la historia aporta más.

4 · ¿Dónde actúa? En la sección ## ✍️ ARTÍCULO de la nota de tarea (en sub-rutina devuelve el markdown al llamador; suelto escribe dentro de la nota).

5 · ¿Qué pasa cuando corre? El tutorial existe completo salvo la vivencia: pasos genéricos verificables, SEO procedimental listo, huecos esperando — publicable: no hasta que narra-experiencia (craft de build) incruste.

6 · ¿Para qué? Para que cada tarea ejecutada se vuelva una página que trabaja sola: atrae por búsqueda, sube autoridad a los conceptos que enlaza, alimenta el corto de la tarea con segundo destino, y es materia prima del artículo de capitulo-curso (carril privado).

7 · ¿Cómo encaja en el motor y su propósito? Ocupa el nodo «artículo tutorial» (DD-03) y encarna la protección del sujeto continuo: pasos sobre sujeto NEUTRO + experiencia del sujeto REAL por los huecos. Desde v2.12 el tutorial pasa el gate — dejó de ser la excepción que publicaba sin vivencia.

8 · ¿Cómo ayuda al viajero? El viajero no redacta: ejecuta y cuenta. El tutorial con su schema y sus CTAs sale de la misma corrida que montó su nota de tarea, y su sección de errores comunes se termina sola con la pregunta 2 de la captura.

9 · ¿Qué pasa si NO corre? La tarea avanza pero el embudo no: sin piso escrito no hay long-tail que atraiga, el corto de la tarea pierde uno de sus dos destinos, y el artículo de capitulo-curso del cierre no tiene qué fundir (la fusión pierde su materia prima).

10 · ¿Cómo se explica?

• A un niño de 5 años: «Escribimos la receta para que cualquiera pueda hacer su propia pieza — y dejamos un espacio para contar qué se nos rompió a nosotros al hacerla.»
• A un colega: «Redacta el tutorial público de una tarea: pasos reproducibles sobre un ejemplo neutro, con huecos donde después entra la experiencia real del proyecto.»
• A un experto: «Redactor del nodo artículo-tutorial: how-to con schema HowTo+Article en @graph, pasos genéricos por diseño (protección de IP: mostrar ≠ enseñar), hueco de build como contrato con narra-experiencia, doble CTA con matiz de fase (descargable propio primero); gate completo desde v2.12.»

11 · ¿A qué se parece? A la receta publicada de un restaurante inteligente: enseña a hacer el plato en casa con ingredientes de supermercado (pasos genéricos), cuenta la anécdota real de la cocina (experiencia), y jamás revela la fórmula de la salsa de la casa (la IP del proyecto).

12 · ¿Cómo sabe el viajero que está bien hecho? Si el H1 es una búsqueda real, no un nombre interno · cada paso lleva su señal de éxito · ningún paso enseña sobre la IP del proyecto · los errores comunes traen el síntoma literal · el hueco está tras los pasos (donde el lector ya entiende la dificultad) · y publicable: no sigue puesto hasta narrar.

13 · ¿Cómo puede mejorar el resultado? Con capturas de build ricas (la pregunta 2 alimenta directamente los errores comunes — la sección que más cola larga atrae) · buenos pasos en la nota (este skill los generaliza: mejores pasos reales → mejor tutorial) · y verificando lo perecedero con fuente fechada en vez de afirmar de memoria.

14 · ¿Qué puede confundir? Confundirlo con el artículo de concepto (este enseña a HACER; aquel a ENTENDER — si te descubres explicando el porqué, eso se enlaza) · esperar pasos sobre el proyecto real (jamás: sujeto neutro; el paso a paso sobre la IP es del curso de pago) · rellenar los huecos a mano · buscarle video propio (el tutorial atómico murió; su corto enlaza al video de FASE) · pedirle el artículo de fase (ese narra la integración, sin paso a paso — son capas distintas que no canibalizan).

15 · ¿De dónde viene el viajero? Normalmente no lo dispara él: llega dentro de la corrida de crea-nota-tarea (momento ②), con los pasos ya redactados como insumo. Suelto, llega con una nota de tarea que perdió o nunca tuvo su artículo.

16 · ¿Qué sigue después de este skill? El viajero ejecuta y responde la captura → el mini-barrido al agotarse las tareas de la fase (narra-experiencia, craft de build, voltea el gate) → el día del cierre salen corto, hooks (ganchos) y carrusel → el día 0 el tutorial se publica apuntando al video de fase ya vivo, y escribe-articulo-capitulo-curso-pago lo funde en el carril privado.

17 · El viajero usándolo (ejemplo ilustrativo, no doctrina). Dentro de la corrida de rig-mandibula, este skill recibe los pasos reales (escritos sobre el personaje del proyecto) y los generaliza: H1 «Cómo riggear una mandíbula en Blender», pasos sobre «tu modelo» con una cabeza genérica de ejemplo, cada uno con su señal («el gizmo aparece en el pivote del mentón»). Los prerrequisitos enlazan [[pesos-de-malla]] sin re-explicarlo. Deja el hueco [TU EXPERIENCIA: problema · proceso · resultado · aprendizaje] tras los pasos, y la sección de errores comunes montada a medias («se completará con la captura»). Schema HowTo con los 6 HowToStep genéricos. Semanas después, la búsqueda «mandíbula doblada fea blender» aterriza a alguien exactamente en la sección de errores comunes — que existe porque el viajero vivió ese error y lo narró.

Posición en la cadena (DD-03)

nota de tarea (pasos ya redactados por crea-nota-tarea)
   → ESTE SKILL: artículo tutorial CON huecos                      (publicable: no)
   ── el viajero EJECUTA la tarea y responde la captura de build ──
   → narra-experiencia (craft de build): compila el bloque + incrusta
   → artículo tutorial completo                          (publicable: si — gate)
   → { cuerpo de corto · 3 hooks · carrusel }

Aguas abajo, escribe-articulo-capitulo-curso-pago funde los artículos tutorial de la fase sobre el sujeto continuo real (carril privado 🔒 → curso de pago). Por eso este artículo debe quedar completo y honesto por sí solo: es la materia prima de la fusión, y lo que se pierda aquí no aparece allá.

Modo de invocación (detéctalo antes de escribir)

• Sub-rutina (lo llama crea-nota-tarea): recibes todo el insumo y no preguntas nada. Entregas el markdown para que el llamador lo coloque en ## ✍️ ARTÍCULO.
• Suelto (DD-02): el viajero te da la nota de tarea. Léela, resuelve el working set mínimo (la nota + la ruta para los CTAs + el Norte para la voz) y escribe dentro de la nota. Si la nota no existe, no la inventes: nombra crea-nota-tarea y detente.

Entrada (contrato)

Del llamador o de la nota: el slug de la tarea · su objetivo y su «hecho» verificable · los pasos ya redactados · los [[conceptos]] prerrequisito · si la tarea lleva 📦 o 📸.

De la ruta (fuente única, DD-05): url_producto · url_lead_magnet · url_newsletter · url_playlist — úsalos si están en el working set; jamás los inventes.

Del Norte: voz del proyecto y datos de entidad-autor para el schema.

No lees: otras notas, otras rutas, el vault completo.

Proceso

1. Decide la intención de búsqueda

Un tutorial responde a una consulta procedimental («cómo hacer X»). Fija la consulta real que resuelve —concreta, con la herramienta y la versión si importan— y escribe el H1 para esa consulta, no para el nombre interno de la tarea. Si el título interno es rig-mandibula, la consulta puede ser «cómo riggear una mandíbula en Blender»: el archivo conserva su nombre atómico, el H1 habla el idioma de quien busca.

2. Investiga solo lo perecedero

Lo declarativo y estable sale de tu conocimiento. Versiones, nombres de menú, atajos, cifras y estado actual se verifican con fuente fechada — y se citan con año. Si no puedes verificarlo, dilo en el texto («en la versión que usé, 4.2») en vez de afirmar algo general.

3. Redacta el artículo COMPLETO (capa humana)

Estructura en references/estructura-tutorial.md. En resumen: respuesta-primero (qué se logra y cuánto toma) → prerrequisitos con sus enlaces → pasos numerados, cada uno con su señal de que salió bien → validación → errores comunes con su síntoma exacto → FAQ → conclusión con doble CTA.

Los pasos son genéricos, la experiencia es real. Esta es la craft central del skill y su línea más delicada:

• Los pasos se escriben sobre un sujeto neutro —un ejemplo equivalente, no la IP del proyecto—: cualquiera puede seguirlos con su propio archivo. Es lo que protege el sujeto continuo: mostrar el resultado no es enseñar a construirlo.
• La experiencia que rodea a esos pasos sí es la real, la del sujeto verdadero, y entra por los huecos. Ahí está el E-E-A-T: nadie más puede escribir qué se rompió a las once de la noche.
• Nunca al revés. Un tutorial con pasos sobre la IP del proyecto regala el curso de pago; un tutorial con experiencia inventada rompe la invariante 10. La combinación correcta es pasos reproducibles + vivencia intransferible.

4. Deja la experiencia como huecos + declara el gate ← CONTRATO con narra-experiencia

Marca los puntos y no los rellenes:

• El hueco de build, uno por artículo, donde la historia de construir aporta más (tras los pasos — sección 6 del orden canónico, antes de errores comunes): [TU EXPERIENCIA: problema · proceso · resultado · aprendizaje]
• Métrica propia suelta, cuando un pasaje la pida: [TU EXPERIENCIA: cifra real + cómo la medí]

Reglas del contrato (qué le garantizas al siguiente eslabón):

1. El hueco va exactamente donde debe ir la narrativa, con su H2 y su contexto ya montados alrededor, para que narra-experiencia solo tenga que incrustar, no reestructurar.
2. Cada hueco declara qué materia prima espera (los cuatro campos del build, o la cifra).
3. Los huecos de estudio (síntesis propia · opinión · transformación y aplicado a mi contexto) no son de este artículo: pertenecen al artículo de concepto. Aquí solo va el build. Si los reclamaras, dos piezas pedirían la misma vivencia y una nacería vacía.
4. Mientras exista un hueco: publicable: no. Esa costura es el gate (v2.12 — el tutorial dejó de ser la excepción que publicaba sin vivencia).

5. Cierra con el DOBLE CTA (DD-05) — leído del frontmatter de la ruta

CTA de contenido: la red de autoridad — el concepto del que depende, la playlist (lista de reproducción), la ruta. CTA de conversión: resolución estándar url_producto → url_lead_magnet → url_newsletter. Matiz de fase (v2.12): si la fase de esta tarea ya tiene su descargable, ese va primero: la oferta más específica convierte mejor. Si el working set no trae las URLs, deja el marcador [CTA_CONVERSIÓN: url_producto|url_lead_magnet|url_newsletter — pendiente de la ruta]. Nunca inventes una URL.

6. Emite el bloque 📦 CAPA TÉCNICA (al final, nunca intercalado)

Según references/capa-tecnica-tutorial.md: meta finales · schema HowTo (con sus step) combinado con Article en un solo @graph · alt definitivo de imágenes · checklist (lista de verificación) de publicación. El schema HowTo es la diferencia con el artículo de concepto y es lo que hace que un tutorial gane el bloque enriquecido de resultados.

7. Entrega

Sub-rutina: devuelve el markdown y una línea de estado. Suelto: escríbelo en ## ✍️ ARTÍCULO de la nota y confirma que publicable: no sigue puesto.

artículo: colocado · consulta: <la que resuelve> · pasos: N · huecos: <N build + N métrica> · CTA conversión: <resuelto a X | marcador> · schema: HowTo+Article → publicable: no

Reglas

• Nunca fabriques experiencia, pasos que no se ejecutaron, casos, métricas, citas, fuentes ni URLs. Sin dato verificable → hueco o marcador.
• Pasos genéricos, experiencia real. Es la regla que sostiene el embudo entero: sin ella, o se regala el curso de pago o se miente en el artículo.
• Fuentes siempre con URL y año; prioriza primarias.
• Cero teoría: los conceptos se enlazan, no se re-explican (DD-01).
• Un solo artículo, un solo cuerpo; la 📦 CAPA TÉCNICA va al final, jamás intercalada.
• El hueco canónico es [TU EXPERIENCIA: ...] — contrato de este skill con narra-experiencia.
• No canibalices: el how-to enseña a hacer; el artículo de concepto enseña a entender. Si te descubres explicando por qué funciona, eso es del concepto: enlázalo.
• Sé conciso en el chat; el trabajo vive en el artículo.

Referencias

• references/estructura-tutorial.md — la estructura del how-to, sección a sección.
• references/capa-tecnica-tutorial.md — meta, schema HowTo, alt y checklist.