alta-wiki
Skill2 starsChanged 4 months agoApache-2.0View on GitHub
Da de alta (o retira) una página de la wiki de la web de docs — nueva guía, nueva página de extensión, nueva página de «empezar», o un contrato de docs/ que pasa a publicarse. La API nueva NO es esta skill (va a /sync-web). Su valor es la checklist mecánica completa de puntos de contacto (docmap, WIKI_SLUGS, i18n, colecciones) y el cierre en verde que garantiza que docmap, el plugin de enlaces y los gates de limpieza quedan coherentes.
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 19
(a) API nueva en
docs/contracts/api.md: NO es esta skill. La referencia /api se deriva de api.md con su propio gate check-drift. - Distinctive: line 87
No está hecho hasta que estas cuatro pasan:
- Distinctive: line 104
Commit en español citando la página dada de alta (o retirada).
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Alta de una página en la wiki
La web publica la Capa 1 de docs/ (contratos vivos) más las páginas
locales de «empezar» y «extensiones», con el orden y los grupos definidos en un
único manifiesto: web/src/lib/docmap.ts. Añadir o quitar una página toca
varios ficheros que deben quedar idénticos entre sí; el valor de esta skill
es esa checklist mecánica — olvidar un punto de contacto rompe el build o filtra
un enlace muerto.
Antes de nada, ubica el caso.
Los cuatro casos de alta
- (a) API nueva en
docs/contracts/api.md. NO es esta skill. La referencia/apise deriva deapi.mdcon su propio gatecheck-drift; una firma o namespace nuevo se publica con/sync-web, no tocando el docmap de la wiki. - (b) Un contrato de
docs/que pasa a publicarse (uno nuevo, o uno hasta hoy interno —comomalla.md— cuando se apruebe). Colecciónwiki: la página se renderiza directamente desde el.mdreal del repo bajodocs/. - (c) Una página local nueva (guía, tutorial, página de una extensión sin
contrato propio). Colección
empezaroextensiones: es un.mdbajoweb/src/content/docs/<carpeta>/con frontmattertitleydescriptiony SIN H1 en el cuerpo (el H1 lo pone la plantilla desde el frontmatter). - (d) Despublicar una página. Se quita de todos los puntos de contacto de
abajo. Si era un contrato de
docs/(colecciónwiki), el fichero no se borra —sigue endocs/, es fuente de verdad— y sus enlaces.mdcaerán solos al blob de GitHub por la rama existente deremark-enlaces-wiki.
Checklist mecánica de puntos de contacto
Estos ficheros son un sistema: docmap.ts es la fuente y el resto lo replica.
Cámbialos juntos.
web/src/lib/docmap.ts— el manifiesto. Añade (o quita) la entrada en su grupo (empezar·espec·extensiones), en la posición correcta del orden de lectura (alimenta prev/next y la statusline), con su colección (wikipara contratos dedocs/;empezar/extensionespara páginas locales) y sugitPath, que sale de la rama degitPath()según la colección:wiki→docs/<subcarpeta>/<slug>.md(la subcarpeta —core/ocontracts/— sale del mapaWIKI_DIRdel propio docmap; si la página nueva es decore/, añade ahí su entrada)empezar→web/src/content/docs/empezando/<slug>.mdextensiones→web/src/content/docs/extensiones/<slug>.md
TOTAL, el 404 y prev/next se derivan solos del docmap; no los toques. Además, para colecciónwiki: la lista EXPLÍCITA de ficheros del glob deweb/src/content.config.ts(colecciónwiki) debe ganar/perder la ruta<subcarpeta>/<slug>.md— sin esa línea la página no se carga (el glob no usa comodines a propósito: docs/ contiene registros internos que no se publican).web/src/lib/markdown/remark-enlaces-wiki.mjs— el setWIKI_SLUGSdebe quedar idéntico a la lista de slugs del docmap (el plugin corre fuera deastro:contenty por eso los replica a mano). Un slug del docmap que falte aquí hace que sus enlaces.mdcaigan a GitHub en vez de quedar internos; uno de más apunta a una página inexistente. La aserción de consistencia detest-limpieza.mjsverifica exactamente este pareo.web/src/lib/i18n.ts— solo si añades un grupo nuevo al sidebar. Cada grupo tiene su etiqueta i18n (s1,s2,s3…) enesyen. Dar de alta una página dentro de un grupo existente NO toca i18n.- Solo caso (c), página local:
- Si la colección ya existe (
empezar,extensiones), basta crear el.mdcon su frontmattertitle/descriptiony sin H1. - Si creas una colección nueva: decláralala en
web/src/content.config.ts(glob sobre su carpeta, schematitle+description), haz queweb/src/pages/docs/[slug].astrola cargue engetStaticPathsy la trate comoempezarpara el H1 desde frontmatter, y añade su rama engitPath()del docmap.
- Si la colección ya existe (
- Solo caso (b), contrato de
docs/: revisa la contaminación de proceso. El pluginremark-limpieza-interno.mjsbarre en build los marcadores parentéticos ((G##),(P##),(S##),(ADR-NNN)) y los blockquotes de estado> ✅ …, así que NO hay que limpiar la fuente a mano. Pero una sección interna entera que no deba publicarse (apéndices de «cuestiones abiertas», estado de implementación, §§ sin aprobar) necesita el par explícito<!-- nu:interno -->…<!-- /nu:interno -->en el.mddedocs/. La trazabilidad restante se queda en la fuente: es correcta, la web la limpia.
Cierre en verde
No está hecho hasta que estas cuatro pasan:
node web/scripts/test-limpieza.mjs— fixtures del plugin y la aserciónWIKI_SLUGS↔ docmap. Si esta última falla, los ficheros de los pasos 1-2 divergieron.npm run buildenweb/— Astro caza slugs muertos en sidebar, prev/next e índice, y valida el frontmatter de la página nueva.npm run check:limpieza— el grep del HTML dedist/: cero marcadores de proceso filtrados. En un contrato nuevo, atención a un(G##)/✅que el plugin no cubriera por estar fuera de un paréntesis o de un blockquote (se arregla en la fuente, no relajando el gate).- Lee el HTML generado de la página nueva en
dist/docs/<slug>/: que el H1 salga del frontmatter (páginas locales), que la prosa quede natural tras el strip (contratos), y que los enlaces a docs despublicados apunten al blob de GitHub y los publicados sigan internos.
Recuerda: TOTAL y el 404 se derivan solos del docmap — no hay que tocarlos.
Commit en español citando la página dada de alta (o retirada).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

