Build Workspace Docs
Regenereert README.md en WORK_AREAS.md in een ai-agent-skills bibliotheek workspace via de CLI
Werkt met setup
Wat het doet
Verpakt het `ai-agent-skills` CLI `build-docs` commando om de README.md en WORK_AREAS.md bestanden van een beheerde skills-library workspace te regenereren vanuit skills.json, zodat shelf tables, skill counts en source tables overeenkomen met de catalogus. Activeert wanneer een gebruiker vraagt om de gegenereerde docs van een ai-agent-skills bibliotheek workspace opnieuw op te bouwen of te synchroniseren na het toevoegen, importeren of cureren van skills. Vereist Node/npx en een geïnitialiseerde workspace die .ai-agent-skills/config.json bevat.
Testrapport
Een echte workspace gebouwd in een tijdelijke HOME (`npx ai-agent-skills@4.3.2 init-library demo-lib --areas "frontend,workflow"`, twee house-copy skills geïmporteerd, daarna een derde catalogusitem toegevoegd aan skills.json om de docs verouderd te maken), twee keer gekopieerd, en twee artefacten geproduceerd: een baseline waar ik README.md/WORK_AREAS.md handmatig bewerkte, en een skill-artefact van de voorgeschreven CLI-flow. De gegenereerde docs verschilden van mijn handmatige bewerking op twee afgeleide regels — README statistieken "3 house copies · 0 cataloged upstream" versus mijn "2 house copies · 1 cataloged upstream", en WORK_AREAS source cell "workspace" versus mijn "upstream/seo-pack" — d.w.z. de CLI leidde tier/author correct af uit skills.json waar ik verkeerd gokte, en een tweede run was byte-identiek (idempotent). Echter, stappen 1 en 3 van de skill (`build-docs --dry-run`, en `--dry-run --format json`) eindigden beide met exit code 1 met "ENOENT ... /opt/homebrew/lib/node_modules/ai-agent-skills/WORK_AREAS.md"; de gepubliceerde 4.3.2 tarball bevat geen WORK_AREAS.md (uitgesloten door .npmignore en package.json files[]), en cli.js:6846 geeft de workspace context door als het options object, zodat `generatedDocsAreInSync` terugvalt op de gebundelde package root. Door het te dwingen te draaien tegen een gepatchte package kopie, toonde het gedocumenteerde `currentlyInSync` veld een vergelijking met de README van de upstream repo zelf in plaats van de workspace, waarbij readmeMatches:false werd gerapporteerd direct na een succesvolle regeneratie. Frontmatter heeft name+description, er worden geen scripts of gebundelde bestanden gerefereerd, en ik vond geen beveiligingsproblemen (geen curl|sh, base64, credential access, of injectietekst) in de 52-regelige SKILL.md.
Getest op: 2026-07-21 · Claude Code 2.x (agent harness)
Installatie
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.
Commando's en voorbeeldprompts
/build-workspace-docsRegenereert README.md en WORK_AREAS.md in een ai-agent-skills bibliotheek workspace via de CLI
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Regenerate the README for this workspaceUpdate WORK_AREAS.md to reflect current skillsPreview doc changes before regenerating them