Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Build Workspace Docs — measured AI agent skill | DecimalAI

moizibnyousaf/build-workspace-docs

NewSkillScoreMaintained

Use when regenerating README.md and WORK_AREAS.md in a managed library workspace. Always dry-run first to preview changes.

Documentationby moizibnyousaf

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Doc Ops pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/moizibnyousaf-build-workspace-docs/SKILL.md

decimalai skills pull moizibnyousaf-build-workspace-docs --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/moizibnyousaf-build-workspace-docs/SKILL.md https://app.decimal.ai/s/moizibnyousaf-build-workspace-docs/SKILL.md

Raw file: /s/moizibnyousaf-build-workspace-docs/SKILL.md ↗ · machine-readable summary at /s/moizibnyousaf-build-workspace-docs.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 2h ago

—-44% tokens0% turns68% of whole cases pass with skill (15/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	25%	0%
case-04	✗→✓	▲ Improved	-47%	0%
case-05	✗→✓	▲ Improved	-30%	0%
case-08	✗→✓	▲ Improved	-17%	0%
case-11	✗→✓	▲ Improved	-54%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

moizibnyousaf / ai-agent-skills

skills/build-workspace-docs/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

Skill contents

SKILL.md

Build Workspace Docs

Goal

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

Guardrails

Always use --dry-run before regenerating docs to preview what will change.
Only run from inside an initialized library workspace (a directory with .ai-agent-skills/config.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.

Workflow

Preview what would change.

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

Regenerate the docs.

bash
npx ai-agent-skills build-docs

Verify the output.

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.

When to Run

After add, catalog, vendor, or curate commands that change the skills catalog.
After bulk imports from a remote library.
Before committing workspace changes to git.

Gotchas

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.

Want to see if moizibnyousaf/build-workspace-docs would activate on your phrasing? Try it before you install — no LLM call, no signup.

Other measured skills in the registry, with their headline benchmark lift.