CommunityProgramación y desarrollogithub.com

trkbt10/indexion-readme

Construcción de README: inicializa estructura de plantillas, genera READMEs por paquete desde comentarios de documentación, planifica tareas de escritura, ensambla el README raíz desde docs/ y READMEs de paquetes mediante configuración doc.json, y verifica ediciones con `plan drift`.

¿Qué es indexion-readme?

Esta habilidad para agentes de IA (compatible con Claude Code, Cursor y otras herramientas similares) automatiza el proceso completo de construcción y mantenimiento de READMEs en proyectos multi-paquete. Su propósito principal es garantizar que la documentación esté siempre sincronizada con el código fuente, reduciendo la fricción en la escritura de documentación y evitando discrepancias. La habilidad funciona mediante un flujo de varios pasos: primero inicializa una estructura de plantillas (como `docs/`) y un archivo de configuración `doc.json` que define los paquetes y sus propiedades. Luego, escanea los comentarios de documentación (como docblocks) en cada paquete para generar un README preliminar. A continuación, planifica las tareas de escritura basándose en la diferencia entre el estado actual y el deseado. Finalmente, ensambla un README raíz combinando el contenido de `docs/` y los READMEs de cada paquete según la configuración, y verifica que las ediciones no introduzcan desviaciones usando el comando `plan drift`. Es especialmente útil para proyectos grandes donde la documentación puede quedar obsoleta rápidamente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/trkbt10/indexion-skills/tree/main/skills/indexion-readme

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace indexion-readme?

Construcción de README: inicializa estructura de plantillas, genera READMEs por paquete desde comentarios de documentación, planifica tareas de escritura, ensambla el README raíz desde docs/ y READMEs de paquetes mediante configuración doc.json, y verifica ediciones con plan drift.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

trkbt10/indexion-agent-orient

Generate and use a pre-edit structure brief so coding agents learn likely owners, consumer surfaces, and unsafe edit locations before implementing.

trkbt10/indexion-documentation

Documentation analysis — assess coverage, detect code-to-doc drift with plan reconcile, visualize dependencies with doc graph. Answers "what needs docs?" and "are docs still accurate?"

trkbt10/indexion-identity

Detect and review name/content drift in code using `indexion identity audit`, then plan verified renames, moves, folder changes, or splits.

trkbt10/indexion-kgf

Debug and inspect KGF specs — view tokenization results, parse trees, and extracted edges from source files. Use when adding/fixing language support or when indexion's analysis output looks wrong.

trkbt10/indexion-refactor

After writing code, detect and clean up duplication at three levels — copy-paste blocks, cross-package shared code, unnecessary wrappers, and concept-level SoT violations. Detect with indexion, fix, and verify.

trkbt10/indexion-sdd

Generate SDD requirements from RFCs/specs and quantitatively verify implementation conformance. spec draft → spec align → spec verify → automated validation loop with codex/claude. Operate spec-to-impl drift gates as CI checks.

trkbt10/indexion-segment

Split text into contextual chunks for RAG/embedding pipelines. Document segmentation and section extraction using window, tfidf, punctuation, or hybrid strategies chosen by intent.

trkbt10/indexion-wiki

Project wiki lifecycle — create pages, track source changes with ingest, update stale pages, lint structural integrity, detect code-to-doc drift with reconcile, and manage search indexes. A runbook for navigating and maintaining the wiki as an agent.

Skills relacionados