{"id":"549d3d15-8e0a-418c-9491-37a055bd7b01","shortId":"Trhzrb","kind":"skill","title":"build-workspace-docs","tagline":"Use when regenerating README.md and WORK_AREAS.md in a managed library workspace. Always dry-run first to preview changes.","description":"# Build Workspace Docs\n\n## Goal\n\nKeep workspace documentation in sync with the skills catalog after adding, removing, or curating skills.\n\n## Guardrails\n\n- Always use `--dry-run` before regenerating docs to preview what will change.\n- Only run from inside an initialized library workspace (a directory with `.ai-agent-skills/config.json`).\n- Never hand-edit the generated sections of README.md or WORK_AREAS.md. The CLI will overwrite them.\n- Use `--format json` to capture structured results for automation pipelines.\n\n## Workflow\n\n1. Preview what would change.\n\n```bash\nnpx ai-agent-skills build-docs --dry-run\n```\n\n2. Regenerate the docs.\n\n```bash\nnpx ai-agent-skills build-docs\n```\n\n3. Verify the output.\n\n```bash\nnpx ai-agent-skills build-docs --dry-run --format json\n```\n\nThe JSON output includes `currentlyInSync` to tell you whether docs were already up to date.\n\n## When to Run\n\n- After `add`, `catalog`, `vendor`, or `curate` commands that change the skills catalog.\n- After bulk imports from a remote library.\n- Before committing workspace changes to git.\n\n## Gotchas\n\n- Running outside a workspace will fail with a clear error. Use `init-library` to create one first.\n- The generated docs use HTML comment markers (`<!-- GENERATED:...:start/end -->`) as boundaries. Do not remove these markers from the template sections.","tags":["build","workspace","docs","agent","skills","moizibnyousaf","agent-skills","claude-code","cli","codex","cursor","developer-tools"],"capabilities":["skill","source-moizibnyousaf","skill-build-workspace-docs","topic-agent-skills","topic-claude-code","topic-cli","topic-codex","topic-cursor","topic-developer-tools","topic-productivity"],"categories":["Ai-Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MoizIbnYousaf/Ai-Agent-Skills/build-workspace-docs","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MoizIbnYousaf/Ai-Agent-Skills","source_repo":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1044 github stars · SKILL.md body (1,333 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T18:52:54.402Z","embedding":null,"createdAt":"2026-04-18T21:56:11.007Z","updatedAt":"2026-05-02T18:52:54.402Z","lastSeenAt":"2026-05-02T18:52:54.402Z","tsv":"'/config.json':72 '1':100 '2':117 '3':130 'ad':38 'add':167 'agent':70,109,125,138 'ai':69,108,124,137 'ai-agent-skil':68,107,123,136 'alreadi':159 'alway':16,44 'autom':97 'bash':105,121,134 'boundari':218 'build':2,24,112,128,141 'build-doc':111,127,140 'build-workspace-doc':1 'bulk':179 'captur':93 'catalog':36,168,177 'chang':23,56,104,174,188 'clear':200 'cli':85 'command':172 'comment':215 'commit':186 'creat':207 'curat':41,171 'currentlyinsync':152 'date':162 'directori':66 'doc':4,26,51,113,120,129,142,157,212 'document':30 'dri':18,47,115,144 'dry-run':17,46,114,143 'edit':76 'error':201 'fail':197 'first':20,209 'format':90,146 'generat':78,211 'git':190 'goal':27 'gotcha':191 'guardrail':43 'hand':75 'hand-edit':74 'html':214 'import':180 'includ':151 'init':204 'init-librari':203 'initi':62 'insid':60 'json':91,147,149 'keep':28 'librari':14,63,184,205 'manag':13 'marker':216,223 'never':73 'npx':106,122,135 'one':208 'output':133,150 'outsid':193 'overwrit':87 'pipelin':98 'preview':22,53,101 'readme.md':8,81 'regener':7,50,118 'remot':183 'remov':39,221 'result':95 'run':19,48,58,116,145,165,192 'section':79,227 'skill':35,42,71,110,126,139,176 'skill-build-workspace-docs' 'source-moizibnyousaf' 'structur':94 'sync':32 'tell':154 'templat':226 'topic-agent-skills' 'topic-claude-code' 'topic-cli' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-productivity' 'use':5,45,89,202,213 'vendor':169 'verifi':131 'whether':156 'work_areas.md':10,83 'workflow':99 'workspac':3,15,25,29,64,187,195 'would':103","prices":[{"id":"e5769fbe-951d-4148-b6ad-f219f2706c71","listingId":"549d3d15-8e0a-418c-9491-37a055bd7b01","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MoizIbnYousaf","category":"Ai-Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:56:11.007Z"}],"sources":[{"listingId":"549d3d15-8e0a-418c-9491-37a055bd7b01","source":"github","sourceId":"MoizIbnYousaf/Ai-Agent-Skills/build-workspace-docs","sourceUrl":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/build-workspace-docs","isPrimary":false,"firstSeenAt":"2026-04-18T21:56:11.007Z","lastSeenAt":"2026-05-02T18:52:54.402Z"}],"details":{"listingId":"549d3d15-8e0a-418c-9491-37a055bd7b01","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MoizIbnYousaf","slug":"build-workspace-docs","github":{"repo":"MoizIbnYousaf/Ai-Agent-Skills","stars":1044,"topics":["agent-skills","claude-code","cli","codex","cursor","developer-tools","productivity"],"license":"mit","html_url":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills","pushed_at":"2026-04-13T19:04:12Z","description":"my curated agent skills library ","skill_md_sha":"c99781b62185ba0081568979088b37f79428f71a","skill_md_path":"skills/build-workspace-docs/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MoizIbnYousaf/Ai-Agent-Skills/tree/main/skills/build-workspace-docs"},"layout":"multi","source":"github","category":"Ai-Agent-Skills","frontmatter":{"name":"build-workspace-docs","description":"Use when regenerating README.md and WORK_AREAS.md in a managed library workspace. Always dry-run first to preview changes."},"skills_sh_url":"https://skills.sh/MoizIbnYousaf/Ai-Agent-Skills/build-workspace-docs"},"updatedAt":"2026-05-02T18:52:54.402Z"}}