build-workspace-docs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Keep workspace documentation in sync with the skills catalog after adding, removing, or curating skills.

在新增、移除或整理技能后，保持工作区文档与技能目录同步。

Always use
```
--dry-run
```
before regenerating docs to preview what will change.
Only run from inside an initialized library workspace (a directory with
```
.workspace.json
```
).
Never hand-edit the generated sections of README.md or WORK_AREAS.md. The CLI will overwrite them.
Use
```
--format json
```
to capture structured results for automation pipelines.

bash

npx ai-agent-skills build-docs --dry-run

bash

npx ai-agent-skills build-docs

bash

npx ai-agent-skills build-docs --dry-run --format json

The JSON output includes

currentlyInSync

to tell you whether docs were already up to date.

bash

npx ai-agent-skills build-docs --dry-run

bash

npx ai-agent-skills build-docs

bash

npx ai-agent-skills build-docs --dry-run --format json

JSON输出包含

currentlyInSync

字段，可告知你文档是否已经是最新版本。

Running outside a workspace will fail with a clear error. Use
```
init-library
```
to create one first.
The generated docs use HTML comment markers (
```

```
) as boundaries. Do not remove these markers from the template sections.