Build Workspace Docs
Regenererer README.md og WORK_AREAS.md i et ai-agent-skills biblioteks-workspace via CLI'en
Virker med opsætning
Hvad det gør
Indkapsler `ai-agent-skills` CLI `build-docs`-kommandoen til at regenerere README.md- og WORK_AREAS.md-filerne i et administreret skills-biblioteks-workspace fra skills.json, så hyldetabeller, skill-tællinger og kildetabeller matcher kataloget. Udløses, når en bruger beder om at genopbygge eller resynkronisere de genererede docs i et ai-agent-skills biblioteks-workspace efter tilføjelse, import eller kuratering af skills. Kræver Node/npx og et initialiseret workspace, der indeholder .ai-agent-skills/config.json.
Testrapport
Byggede et rigtigt workspace i en temp HOME (`npx ai-agent-skills@4.3.2 init-library demo-lib --areas "frontend,workflow"`, importerede to house-copy skills, tilføjede derefter en tredje katalogindgang til skills.json for at gøre docs forældede), kopierede det to gange og producerede to artefakter: en baseline, hvor jeg manuelt redigerede README.md/WORK_AREAS.md, og et skill-artefakt fra den foreskrevne CLI-flow. De genererede docs afveg fra min manuelle redigering på to afledte linjer — README-statistikker "3 house copies · 0 cataloged upstream" vs mine "2 house copies · 1 cataloged upstream", og WORK_AREAS source cell "workspace" vs mine "upstream/seo-pack" — dvs. CLI afledte tier/author korrekt fra skills.json, hvor jeg gættede forkert, og et andet kørsel var byte-identisk (idempotent). Dog afsluttede trin 1 og 3 af skillen (`build-docs --dry-run`, og `--dry-run --format json`) begge med exit code 1 med "ENOENT ... /opt/homebrew/lib/node_modules/ai-agent-skills/WORK_AREAS.md"; den publicerede 4.3.2 tarball indeholder ingen WORK_AREAS.md (udelukket af .npmignore og package.json files[]), og cli.js:6846 sender workspace-konteksten som options-objektet, så `generatedDocsAreInSync` falder tilbage til den medfølgende pakkerod. At tvinge den til at køre mod en patched pakke-kopi viste det dokumenterede `currentlyInSync`-felt, der sammenlignede med upstream-repoets egen README i stedet for workspace, og rapporterede readmeMatches:false lige efter en vellykket regenerering. Frontmatter har name+description, ingen scripts eller medfølgende filer er refereret, og jeg fandt ingen sikkerhedsbrister (ingen curl|sh, base64, credential-adgang eller injektionstekst) i den 52-linjers SKILL.md.
Testet: 2026-07-21 · Claude Code 2.x (agent harness)
Installation
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.
Kommandoer og eksempelprompter
/build-workspace-docsRegenererer README.md og WORK_AREAS.md i et ai-agent-skills biblioteks-workspace via CLI'en
Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):
Regenerate the README for this workspaceUpdate WORK_AREAS.md to reflect current skillsPreview doc changes before regenerating them