Agent skill

Build Workspace Docs

by MoizIbnYousaf in MoizIbnYousaf/ai-agent-skills

A skill your agent uses when regenerating README.md and WORKAREAS.md in a managed library workspace.

MITAuto-check passedDocuments & Office

Install Build Workspace Docs

skills CLI
$ npx skills add MoizIbnYousaf/ai-agent-skills --skill build-workspace-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MoizIbnYousaf/ai-agent-skills build-workspace-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MoizIbnYousaf/ai-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/build-workspace-docs .claude/skills/build-workspace-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
build-workspace-docs
GitHub stars
1.1k
Token cost
~385 tokens
SKILL.md length
159 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when regenerating README.md and WORKAREAS.md in a managed library workspace.

  • Works in 3 steps: Preview what would change. → Regenerate the docs. → Verify the output.
  • Regenerating README.md and WORKAREAS.md in a managed library workspace
  • SKILL.md covers Goal, Guardrails, Workflow and When to Run, plus 1 more section
  • Calls npx

What it does

Build Workspace Docs is an agent skill from MoizIbnYousaf/ai-agent-skills. Use when regenerating README.md and WORKAREAS.md in a managed library workspace. Always dry-run first to preview changes.

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Cloud office suites. The repository describes itself as: Universal skill installer and package manager for AI coding agents. One command, 12+ runtimes. npx ai-agent-skills. The licence is MIT.

When your agent uses it

  • Regenerating README.md and WORKAREAS.md in a managed library workspace
  • Tasks that involve Cloud office suites

Example prompts

  • “/build-workspace-docs”

Requirements

  • Node.js

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Preview what would change.
  2. Regenerate the docs.
  3. Verify the output.

What it can do on your machine

Read from SKILL.md and the folder at commit 6d95c78. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Build Workspace Docs loads about 385 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 159 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~385

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MoizIbnYousaf/ai-agent-skills at commit 6d95c78, republished under its MIT licence (© MoizIbnYousaf). 159 words, ~385 tokens.

Download SKILL.mdSave it as .claude/skills/build-workspace-docs/SKILL.md (or your agent's skills folder).
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.
category
workflow
version
4.1.0

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

  1. Preview what would change.
bash
npx ai-agent-skills build-docs --dry-run
  1. Regenerate the docs.
bash
npx ai-agent-skills build-docs
  1. 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 (<!-- GENERATED:...:start/end -->) as boundaries. Do not remove these markers from the template sections.

© MoizIbnYousaf, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/build-workspace-docs of MoizIbnYousaf/ai-agent-skills.

Open the folder on GitHubat commit 6d95c78

Compare with similar skills

Build Workspace Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Build Workspace Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Build Workspace Docs this skillMoizIbnYousaf/ai-agent-skills1.1k—~385Automated safety check: PassMIT
Community Google WorkspaceArgentAIOS/argentos-core126—~2.8kAutomated safety check: PassMIT
AI Agent PostureSCStelz/security-investigator250—~21kAutomated safety check: PassMIT
Local Vscuse ValidationOfficeDev/microsoft-365-agents-toolkit781—~10kAutomated safety check: WarnCustom licence
Google WorkspaceTommy-yw/RunbookHermes5461 repos~2.7kAutomated safety check: PassMIT
Google Workspaceswarmclawai/swarmclaw688—~680Automated safety check: PassMIT

Similar skills

  • Community Google Workspace

    ArgentAIOS/argentos-core

    Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for community skills.

    126 GitHub stars~2.8k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • AI Agent Posture

    SCStelz/security-investigator

    Audit or report on AI agent security posture across Copilot Studio, Microsoft 365 Copilot, Microsoft Foundry, and third-party agents.

    250 GitHub stars~21k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Local Vscuse Validation

    OfficeDev/microsoft-365-agents-toolkit

    A skill your agent uses when: setting up shared local vscuse prerequisites, credentials, runner, local or pinned published Docker images, local VSIX, env variables, and common rules for Microsoft…

    781 GitHub stars~10k tokensUpdated today
    Documents & OfficeAuto-check: warnings
  • Google Workspace

    Tommy-yw/RunbookHermes

    Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for Hermes.

    546 GitHub starsUsed in 1 repo~2.7k tokens
    Documents & OfficeAuto-check passed
  • Google Workspace

    swarmclawai/swarmclaw

    Use Google Workspace CLI (gws) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks.

    688 GitHub stars~680 tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Gws Install

    jezweb/claude-skills

    Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials.

    1.1k GitHub stars~1.1k tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed

More from MoizIbnYousaf/ai-agent-skills

All 15 skills in this repo
  • Database Design

    MoizIbnYousaf/ai-agent-skills

    Database schema design, optimization, and migration patterns for PostgreSQL, MySQL, and NoSQL databases.

    1.1k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • LLM Application Dev

    MoizIbnYousaf/ai-agent-skills

    Building applications with Large Language Models - prompt engineering, RAG patterns, and LLM integration.

    1.1k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Audit Library Health

    MoizIbnYousaf/ai-agent-skills

    A skill your agent uses when checking the overall health of a skills library.

    1.1k GitHub stars~518 tokensUpdated 18 days ago
    Auto-check passed
  • Backend Development

    MoizIbnYousaf/ai-agent-skills

    Backend API design, database architecture, microservices patterns, and test-driven development.

    1.1k GitHub stars~853 tokensUpdated 18 days ago
    Auto-check passed
  • Browse And Evaluate

    MoizIbnYousaf/ai-agent-skills

    A skill your agent uses when exploring the ai-agent-skills catalog to find, compare, and evaluate skills before installing.

    1.1k GitHub stars~453 tokensUpdated 18 days ago
    Auto-check passed
  • Code Documentation

    MoizIbnYousaf/ai-agent-skills

    Writing effective code documentation - API docs, README files, inline comments, and technical guides.

    1.1k GitHub stars~1.4k tokensUpdated 18 days ago
    Auto-check passed

Questions about Build Workspace Docs

What does Build Workspace Docs do?

A skill your agent uses when regenerating README.md and WORKAREAS.md in a managed library workspace. Build Workspace Docs is an agent skill from MoizIbnYousaf/ai-agent-skills.md in a managed library workspace.

When should I use Build Workspace Docs?

Build Workspace Docs fits situations like: regenerating README.md and WORKAREAS.md in a managed library workspace; tasks that involve Cloud office suites.

How do I install Build Workspace Docs in Claude Code?

Run `npx skills add MoizIbnYousaf/ai-agent-skills --skill build-workspace-docs -a claude-code`. Or copy the skill folder (skills/build-workspace-docs in MoizIbnYousaf/ai-agent-skills) into .claude/skills/build-workspace-docs in your project. Claude Code loads it when a task matches its description.

How do I install Build Workspace Docs in Codex?

Run `npx skills add MoizIbnYousaf/ai-agent-skills --skill build-workspace-docs -a codex`. Or copy the skill folder (skills/build-workspace-docs in MoizIbnYousaf/ai-agent-skills) into .agents/skills/build-workspace-docs in your project. Codex loads it when a task matches its description.

Can I use Build Workspace Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MoizIbnYousaf/ai-agent-skills --skill build-workspace-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/build-workspace-docs, .gemini/skills/build-workspace-docs, .github/skills/build-workspace-docs and .opencode/skills/build-workspace-docs in your project.

What does Build Workspace Docs need to run?

Going by SKILL.md and its folder, Build Workspace Docs needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Build Workspace Docs access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Build Workspace Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Build Workspace Docs use?

Build Workspace Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Build Workspace Docs use?

About 385 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Build Workspace Docs?

Skills that share tags, products or a category with Build Workspace Docs: Community Google Workspace (ArgentAIOS/argentos-core, 126 stars), AI Agent Posture (SCStelz/security-investigator, 250 stars), Local Vscuse Validation (OfficeDev/microsoft-365-agents-toolkit, 781 stars) and Google Workspace (Tommy-yw/RunbookHermes, 546 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Build Workspace Docs?

MoizIbnYousaf (a GitHub user) maintains it in MoizIbnYousaf/ai-agent-skills, which has 1,149 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 21, 2026.

Source: MoizIbnYousaf/ai-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.