Cuerpo del artículo: tono y estructura con la skill markeup-content

La skill markeup-content —«Redacta el cuerpo Markdown de un post del vault MarkeUP»— es una de las habilidades que el sistema MarkeUP tiene escritas para Hermes Agent y para Cline. Esta página es su ficha pública: lo que sabe hacer, cuándo se usa y qué comandos ejecuta.

Aquí vive la parte que lee la gente: párrafos, secciones y tono. La skill los ordena sin inventar datos.

El texto de la sección «Instrucciones del canon» está transcrito del fichero fuente —que se escribe sin tildes por convención de su propio gate—, así que es exactamente lo que lee el agente cuando le pides algo. La cabecera y esta entradilla sí están redactadas para leerlas.

Dato	Valor
Skill	`markeup-content`
Responsabilidad	Redacta el cuerpo Markdown de un post del vault MarkeUP.
Versión	1.3.0
Autoría	uriszarernesto-blip · licencia MIT
Plataformas	linux · macos
Tags del canon	markeup · redaccion · estilo · markdown · astro
Skills relacionadas	markeup-context · markeup-frontmatter · markeup-wikilinks · markeup-seo
Fuente	`~/.hermes/skills/markeup/markeup-content/SKILL.md`

Responsabilidad unica: producir el cuerpo del post (sin frontmatter, sin wikilinks). El frontmatter es de markeup-frontmatter; los wikilinks los inserta markeup-wikilinks.

Para redactar o reestructurar el cuerpo de una nota.
Para revisar si un post cumple la estructura y el tono del vault.

Primero lee markeup-context y rules/style-guide.md. Plantilla y detalle: templates/post-body.md, references/style-rules.md.

<!-- Sin H1: lo pinta la plantilla (PostHero.astro) desde el `title` del frontmatter -->

**Concepto clave en negrita** - introduccion de 2-3 frases con contexto.

## Seccion 1 - Contexto/Definicion (H2)
Desarrollo del concepto principal. 2-3 parrafos.

### Sub-seccion (H3) - opcional
Detalle especifico. 1-2 parrafos.

## Seccion 2 - Desarrollo/Analisis (H2)
2-4 parrafos con analisis, ejemplos, relaciones entre conceptos.

## Seccion 3 - Aplicacion/Cierre (H2)
1-2 parrafos con conclusion o reflexion final.

## Fuentes y Aclaraciones  (solo si aplica)
### Fuentes
1. Fuente 1
### Aclaraciones
1. **[1] Termino:** definicion breve.

Misma estructura, sin H3, maximo 3 secciones H2.

Tono y voz (style-guide.md):

Profesional pero accesible; el lector no necesita ser experto.
Segunda persona informal (“tu”) al dirigirse al lector.
Primera persona plural (“nosotros”) solo en reflexiones editoriales.
Tercera persona para analisis objetivos.
Tecnicismos: definirlos o enlazarlos.
Sin juicios absolutos: “puede”, “suele”, “a menudo” en vez de “siempre”, “nunca”.
Optimista y constructivo, incluso en temas dificiles.

Estructura:

Sin H1 en el cuerpo: el H1 lo renderiza la plantilla (PostHero.astro) desde el title del frontmatter. Repetirlo muestra el título dos veces y deja la página con dos H1 (defecto SEO/a11y). El cuerpo empieza por el párrafo de introducción.
Cada H2 lleva al menos un parrafo debajo.
Parrafos de maximo 6 lineas (dividir si son mas largos).
Jerarquia estricta: H2 > H3 > H4, sin saltos.

Formato de texto:

Negritas: concepto clave la primera vez; maximo 1-2 por parrafo.
Cursivas: titulos de obras (El libro del desasosiego), palabras extranjeras sin adaptar (grounding, prana), enfasis sutil.
Listas: numeradas para secuencias ordenadas; - para agrupaciones sin orden.
Tablas: para comparaciones; maximo 3-4 columnas, siempre con encabezado.
Bloques de codigo: solo en Máquina/Documentación, con lenguaje (```javascript).

SEO on-page:

Primer parrafo con la palabra clave principal.
Sin H1 en el cuerpo (lo pone la plantilla); H2 para secciones; H3 para sub-secciones.
Description 140-200 caracteres (se genera en markeup-frontmatter).

❌ Parrafos de mas de 6 lineas.
❌ Headings sin contenido debajo.
❌ Listas de wikilinks al final del post (los enlaces van integrados en el texto).
❌ Frases como “En este articulo vamos a hablar de…” (ir directo al grano).
❌ Mas de 2 negritas por parrafo.
❌ Insertar wikilinks tu mismo: delega en markeup-wikilinks.

Ese archivo es un registro historico y contiene afirmaciones obsoletas (p. ej. presenta [[slug]] sin alias como sintaxis valida). No lo uses como guia normativa. La autoridad es rules/style-guide.md + rules/wikilinks-spec.md.

Devuelve el cuerpo sin frontmatter, con un marcador claro del final. En el pipeline, el paso siguiente (markeup-wikilinks) insertara los enlaces.

El cuerpo no tiene un validador propio: lo revisan, junto al resto de la nota, los gates que corre npm run verify:content (frontmatter, SEO, wikilinks, libros y medios).

Obsidian: cuerpo completo en un bloque markdown, listo para pegar bajo el frontmatter.
Telegram: no vuelques 1500 palabras. Envia la introduccion y el esquema de secciones.
VS Code / Cline: cuerpo completo + diff si modificas una nota existente.
Hermes CLI: cuerpo completo, one-shot.

templates/post-body.md - esqueleto con placeholders.
references/style-rules.md - guia de estilo destilada y contrastada.
markeup-context - dependencia obligatoria.

¿Quieres saber cómo se piden estas cosas? La guía completa está en skills de Hermes Agent, con la chuleta de objetivos y los casos paso a paso.

Cuerpo del artículo

Cuerpo del artículo: tono y estructura con la skill markeup-content

Posts que enlazan a este artículo