CommunityRedacción y edicióngithub.com

substack-research

Enriquece el borrador de un artículo de Substack (o de cualquier newsletter o blog) antes de escribir la versión final. Empieza con una entrevista corta y pide el borrador o cualquier material; después cruza la idea con lo que ya has publicado, con tus propios archivos de contexto (voz, casos, notas) y con un research web ligero, y entrega un dossier por secciones con enlaces internos, pruebas propias, datos externos con fuente, revisión de tono, títulos y un prompt para seguir en otro chat. No reescribe tu borrador. Úsala cuando digas "nuevo Substack", "research para mi artículo", "enriquece este borrador", "tengo un esqueleto de post" o "/substack-research". No es para posts cortos de redes sociales.

¿Qué es substack-research?

substack-research is a Claude Code agent skill that enriquece el borrador de un artículo de Substack (o de cualquier newsletter o blog) antes de escribir la versión final. Empieza con una entrevista corta y pide el borrador o cualquier material; después cruza la idea con lo que ya has publicado, con tus propios archivos de contexto (voz, casos, notas) y con un research web ligero, y entrega un dossier por secciones con enlaces internos, pruebas propias, datos externos con fuente, revisión de tono, títulos y un prompt para seguir en otro chat. No reescribe tu borrador. Úsala cuando digas "nuevo Substack", "research para mi artículo", "enriquece este borrador", "tengo un esqueleto de post" o "/substack-research". No es para posts cortos de redes sociales.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gerardocolindresx/claude-skills/tree/main/substack-research

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Substack research

Tú escribes tus artículos: haces un esqueleto con las ideas y una primera versión (a mano o con otro chat). Esta skill no escribe por ti. Le da a tu borrador lo que le falta: tu propio contexto, enlaces a lo que ya publicaste, pruebas y un research ligero, todo con su fuente.

Habla en el idioma del usuario (por defecto, español), tuteando y sin relleno.

Reglas que no se rompen

  • No reescribas el borrador. Propón qué añadir y dónde; la escritura es del autor. Solo escribe una versión completa si te la pide expresamente.
  • Nunca inventes datos del autor (cifras, resultados, clientes, historias). Si un dato suyo sale de un archivo que no es su fuente de casos, cita la ruta y márcalo [CONFIRMAR]. Si no existe, pregúntalo.
  • Todo dato externo lleva fuente (URL). Si solo lo has visto en un resumen o la fuente no es fiable: [VERIFICAR]. Suposiciones: [INFERIDO].
  • Lo que el autor marque como privado (pregunta 7) no se busca fuera ni aparece en el dossier. Nombres de clientes finales u otros datos personales: enmascáralos ([CLIENTE], [EMAIL]).
  • No avances sin su OK al final del paso 0.
  • Citas cortas: como máximo una frase entre comillas por fuente.

Configuración (solo la primera vez)

Busca en la carpeta de trabajo un archivo substack-research.config.md. Si existe, léelo y salta este apartado.

Si no existe, pregunta en un solo mensaje dónde están estas cosas (todas opcionales):

  1. Artículos ya publicados: una carpeta con los textos o un índice, o la URL de la publicación (para leerla de su web o su feed).
  2. Guía de voz o de estilo.
  3. Casos, cifras y resultados propios que se pueden publicar (la única fuente válida para datos del autor).
  4. Otros contextos útiles: posicionamiento, cliente ideal, notas, transcripciones (solo versiones ya anonimizadas).
  5. Dónde guardar los dossiers.
  6. Carpetas que no se deben leer (borradores privados, datos de clientes).

Ofrece guardar las respuestas en substack-research.config.md para no volver a preguntar. Si el autor no tiene nada de esto, sigue igual: trabajarás con su borrador y la web, y al final le dirás qué archivo le habría ayudado más (por ejemplo, una guía de voz o un índice de lo publicado).

Modelo y esfuerzo por fase

Regla de fondo: el modelo más capaz donde se decide, el más barato donde se mueve volumen. En la escritura, el coste real es el tiempo que el autor pasa editando, no los tokens: un borrador cuesta céntimos en cualquier modelo.

FaseModelo · esfuerzoCómo
0 · Configuración, entrevista y resumenEl más capaz (familia Opus) · mediumSesión principal
1-2 · Buscar en lo publicado y en los archivos del autorEl más rápido (familia Haiku) · lowSubagente que devuelve rutas y extractos, no archivos enteros
3 · Research webIntermedio (familia Sonnet) · medium1-3 subagentes en paralelo, uno por frente
3b · Verificar datos dudosos o claveEl más capaz · highSesión principal, solo esos datos
4 · Revisión de tonoEl más capaz · mediumSesión principal
5 · Dossier (y borrador si lo pide)El más capaz · mediumSesión principal
6 · Verificación finalIntermedio · mediumSubagente
Tareas mecánicas (erratas, formato)El más rápido · lowSubagente

Si no puedes lanzar subagentes con otro modelo, hazlo todo en la sesión principal.

Cuándo preguntar por el modelo

Al empezar y al pasar de fase, comprueba con qué modelo y esfuerzo trabaja la sesión principal. Si no tienes claro que sea la mejor opción para lo que viene, para y pregunta antes de seguir. Por ejemplo:

  • La sesión usa un modelo rápido y toca escribir, revisar el tono o verificar un dato clave.
  • La sesión usa el modelo más capaz con esfuerzo alto para una fase mecánica larga.
  • No puedes usar subagentes y la fase siguiente mueve mucho texto.
  • La tarea se sale de lo previsto (un análisis de datos, un prototipo).

Pregunta en tres líneas:

  1. Qué estás usando y para qué fase.
  2. Por qué crees que no es la mejor herramienta: qué se arriesga (calidad, tiempo de edición) o qué se desperdicia (tokens, dinero).
  3. Opciones: seguir así o cambiar (a qué modelo y esfuerzo, con /model y /effort), con tu recomendación marcada.

Para los subagentes decide tú según la tabla, sin preguntar.

Paso 0 · Sentar las bases

0.1 Pide el material. Primer mensaje, siempre (después de la configuración, si tocaba):

Pásame lo que tengas para esta pieza: tu borrador o esqueleto (pegado o la ruta del archivo), la versión que hayas trabajado en otro chat, notas, enlaces, capturas, una transcripción o la conversación que te la inspiró. Con una sola cosa me vale.

Espera a recibir al menos una. Si es una ruta, léela; si es una URL, léela con la herramienta web disponible.

0.2 Entrevista en dos tandas. Usa la herramienta de preguntas si existe; si no, pregunta en texto. Sáltate las preguntas que el material ya responde y di cuáles has dado por respondidas y con qué.

Tanda 1 · la idea

  1. ¿Qué quieres que el lector piense o haga distinto al terminar? (la tesis en una frase)
  2. ¿Para quién es exactamente? (rol y situación)
  3. ¿De dónde sale: algo que te pasó, un proyecto, un error, una conversación?
  4. ¿Qué parte te parece todavía débil o sin prueba?

Tanda 2 · la forma 5. Formato: método por pasos, caso, opinión o tutorial. 6. ¿Habrá regalo o plantilla? 7. ¿Hay algo que no quieres contar (cliente, cifras, empresa)? 8. ¿Fecha prevista de publicación?

0.3 Resumen y OK. Devuelve 5 líneas: tesis · lector · origen · huecos · formato (y lo privado, si hay). Pregunta si arrancas. No sigas sin su OK.

Paso 1 · Lo ya publicado

Con lo que indicó la configuración (carpeta, índice o URL de la publicación):

  • Qué artículos enlazar y en qué sección exacta del borrador (con la frase donde iría el enlace).
  • Si encaja en una serie o tema recurrente.
  • Si repite algo ya contado: dilo y propón cómo evitarlo o aprovecharlo ("como conté en…").
  • Si existe un post corto (LinkedIn, X) sobre la misma idea, dilo primero: el artículo puede ser su versión larga.

Si no hay nada publicado todavía, dilo en una línea y sigue.

Paso 2 · Cruce con los archivos del autor

Lee primero su guía de voz y su fuente de casos, si existen. Después busca por los términos clave de la tesis en las carpetas que indicó (nunca en las excluidas). Para cada sección del borrador: casos, cifras, frases propias o aprendizajes que la refuercen, con su ruta. No uses como fuente archivos marcados como vacíos o pendientes de rellenar. Si encuentras contradicciones entre el borrador y sus archivos, señálalas. Si no indicó ningún archivo ni carpeta, salta este paso y apunta en "Pendiente de confirmar" las pruebas propias que le faltan al borrador.

Paso 3 · Research externo ligero

Entre 5 y 8 fuentes como máximo, con la herramienta de búsqueda web disponible. Busca solo lo que el borrador necesita:

  • Datos o benchmarks para las afirmaciones que lo piden (empieza por la respuesta a la pregunta 4).
  • Verificación de las afirmaciones del borrador que citan a terceros (fechas, cifras, quién lo dijo). Si una no se sostiene, dilo y propón la versión correcta.
  • El mejor argumento en contra de la tesis y cómo responderlo.
  • Uno o dos ejemplos de empresas o personas reales.
  • Qué se ha publicado ya sobre el tema, para diferenciarse (no para copiar).

Cada hallazgo: dato · fuente (URL) · fecha si la tiene · sección donde encaja. Si no tienes ninguna herramienta de búsqueda web, dilo antes de empezar este paso: lista qué buscarías y por qué, y marca como [VERIFICAR] todas las afirmaciones externas del borrador. No completes datos de memoria.

Paso 4 · Revisión de tono

Compara el borrador con su guía de voz y con sus artículos publicados (si los hay):

  • Qué rasgos suyos faltan: cómo abre, si cuenta algo propio, cómo cierra, recursos que repite.
  • Frases que suenan genéricas o a texto de IA: cita la frase y explica cómo acercarla a su voz, sin reescribir el párrafo.
  • Si tienes instalada la skill anti-ai-slop, usa sus listas para detectar esas frases y el formato que delata a la IA (negrita por todas partes, emojis, rayas largas).
  • Erratas evidentes.

Si no hay guía ni artículos publicados, limítate a señalar lo genérico y las erratas.

Paso 5 · Dossier

Guárdalo donde indicó la configuración (si no indicó nada, junto al borrador o en la carpeta de trabajo) como AAAA-MM-slug-research.md. Enseña la ruta y un resumen de 5 líneas en el chat.

# Research · <tema>
> Fecha · borrador base: <ruta o "pegado"> · Estado: research

## Bases (paso 0)
Tesis · Lector · Origen · Huecos · Formato · Privado

## Lo más importante antes de seguir escribiendo
(3 puntos como máximo: duplicados, afirmaciones que corregir, la mejor prueba propia)

## Por sección del borrador
### <Sección tal como la llamó el autor>
- Enlazar a: …
- De tus archivos: … (ruta)
- Dato externo: … (fuente)
- Tono: …

## El argumento en contra y cómo responderlo
## Enlaces internos y serie
## Títulos alternativos (3) y subtítulo
## Idea de regalo o plantilla
## Pendiente de confirmar ([CONFIRMAR] / [VERIFICAR])
## Fuentes
## Prompt para seguir en otro chat
(un bloque listo para pegar: tesis, lector, voz resumida y lista de añadidos por sección)

Paso 6 · Cierre

  • Pregunta qué partes quiere incorporar o investigar más.
  • Si quiere que escribas la versión final, hazlo con el modelo más capaz, mantén su estructura y deja marcado con [CONFIRMAR] todo lo que solo él puede aportar (historias, cifras propias).
  • Recuérdale que, al publicar, añada el artículo a su índice de publicados para que la próxima vez se pueda enlazar.

Skills relacionados