Build Workspace Docs
Regenera README.md y WORK_AREAS.md en un espacio de trabajo de biblioteca ai-agent-skills a través del CLI
Funciona con configuración
Qué hace
Envuelve el comando `build-docs` del CLI `ai-agent-skills` para regenerar los archivos README.md y WORK_AREAS.md de un espacio de trabajo de biblioteca de habilidades gestionado a partir de skills.json, de modo que las tablas de estanterías, los recuentos de habilidades y las tablas de origen coincidan con el catálogo. Se activa cuando un usuario solicita reconstruir o resincronizar la documentación generada de un espacio de trabajo de biblioteca de habilidades ai-agent-skills después de añadir, importar o curar habilidades. Requiere Node/npx y un espacio de trabajo inicializado que contenga .ai-agent-skills/config.json.
Informe de la prueba
Construí un espacio de trabajo real en un HOME temporal (`npx ai-agent-skills@4.3.2 init-library demo-lib --areas "frontend,workflow"`, importé dos habilidades de copia local, luego añadí una tercera entrada de catálogo a skills.json para que la documentación quedara obsoleta), lo copié dos veces y produje dos artefactos: una línea base donde edité manualmente README.md/WORK_AREAS.md, y un artefacto de habilidad del flujo CLI prescrito. La documentación generada difirió de mi edición manual en dos líneas derivadas — las estadísticas de README "3 house copies · 0 cataloged upstream" vs mi "2 house copies · 1 cataloged upstream", y la celda de origen de WORK_AREAS "workspace" vs mi "upstream/seo-pack" — es decir, el CLI derivó correctamente el nivel/autor de skills.json donde yo me equivoqué, y una segunda ejecución fue idéntica en bytes (idempotente). Sin embargo, los pasos 1 y 3 de la habilidad (`build-docs --dry-run`, y `--dry-run --format json`) salieron con código 1 con "ENOENT ... /opt/homebrew/lib/node_modules/ai-agent-skills/WORK_AREAS.md"; el tarball publicado 4.3.2 no contiene WORK_AREAS.md (excluido por .npmignore y package.json files[]), y cli.js:6846 pasa el contexto del espacio de trabajo como objeto de opciones, por lo que `generatedDocsAreInSync` recurre a la raíz del paquete incluido. Forzar su ejecución contra una copia de paquete parcheada mostró que el campo `currentlyInSync` documentado comparaba con el propio README del repositorio upstream en lugar del espacio de trabajo, informando readmeMatches:false justo después de una regeneración exitosa. El frontmatter tiene name+description, no se referencian scripts ni archivos incluidos, y no encontré problemas de seguridad (no curl|sh, base64, acceso a credenciales o texto de inyección) en el SKILL.md de 52 líneas.
Probado el: 2026-07-21 · Claude Code 2.x (agent harness)
Instalación
git clone --depth 1 https://github.com/MoizIbnYousaf/Ai-Agent-Skills.git /tmp/build-workspace-docs-src mkdir -p ~/.claude/skills cp -R /tmp/build-workspace-docs-src/skills/build-workspace-docs ~/.claude/skills/build-workspace-docs # Runtime dependency (not stated in SKILL.md): Node.js + network for `npx ai-agent-skills`. # Only usable inside a workspace created by: npx ai-agent-skills init-library <name> # Alternative install via the project's own CLI: npx ai-agent-skills install build-workspace-docs # KNOWN BREAKAGE (verified on ai-agent-skills@4.3.2): steps 1 and 3 of the skill body # (`build-docs --dry-run` and `build-docs --dry-run --format json`) exit 1 with # "ENOENT ... node_modules/ai-agent-skills/WORK_AREAS.md" because that file is # excluded from the published npm tarball. Run the bare `npx ai-agent-skills build-docs` instead.
Comandos y prompts de ejemplo
/build-workspace-docsRegenera README.md y WORK_AREAS.md en un espacio de trabajo de biblioteca ai-agent-skills a través del CLI
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Regenerate the README for this workspaceUpdate WORK_AREAS.md to reflect current skillsPreview doc changes before regenerating them