Agent skill

Workspace Analyzer

by bonigarcia in bonigarcia/context-engineering

Inspect a workspace, identify temporary files, and perform only approved cleanup or organization steps.

Apache-2.0Auto-check passedAgent Workflows

Install Workspace Analyzer

skills CLI
$ npx skills add bonigarcia/context-engineering --skill workspace-analyzer -a claude-code

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

GitHub CLI
$ gh skill install bonigarcia/context-engineering workspace-analyzer --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/bonigarcia/context-engineering.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ch04/agent-skills/workspace-analyzer .claude/skills/workspace-analyzer && 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
workspace-analyzer
GitHub stars
164
Token cost
~175 tokens
SKILL.md length
87 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Inspect a workspace, identify temporary files, and perform only approved cleanup or organization steps.

  • Works in 5 steps: Use find or the platform equivalent to… → Run git status --short before making… → Present the findings to the user and… → …
  • Tasks that involve Context engineering
  • Calls git

What it does

Workspace Analyzer is an agent skill from bonigarcia/context-engineering. Inspect a workspace, identify temporary files, and perform only approved cleanup or organization steps.

Its SKILL.md is about 180 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 Agent Workflows, covering Context engineering. It works with Model Context Protocol. The repository describes itself as: Context Engineering: Build Consistent, Accurate, Predictable AI Systems. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Context engineering

Example prompts

  • “/workspace-analyzer”

Workflow steps

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

  1. Use find or the platform equivalent to locate temporary files such as .tmp, .bak, and editor backup files.
  2. Run git status --short before making changes so tracked and untracked files are easy to distinguish.
  3. Present the findings to the user and wait for confirmation before deleting or moving anything.
  4. Delete only the approved files, then rerun the scan to verify the workspace is clean.
  5. When reorganizing files, group them by extension into clearly named folders and report every move.

What it can do on your machine

Read from SKILL.md and the folder at commit fe02d5e. 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:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

Workspace Analyzer loads about 175 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 87 words of instructions outside code blocks.

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

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 bonigarcia/context-engineering at commit fe02d5e, republished under its Apache-2.0 licence (© bonigarcia). 87 words, ~175 tokens.

Download SKILL.mdSave it as .claude/skills/workspace-analyzer/SKILL.md (or your agent's skills folder).
name
workspace-analyzer
description
Inspect a workspace, identify temporary files, and perform only approved cleanup or organization steps.

Workspace Analyzer

Instructions

  1. Use find or the platform equivalent to locate temporary files such as .tmp, .bak, and editor backup files.
  2. Run git status --short before making changes so tracked and untracked files are easy to distinguish.
  3. Present the findings to the user and wait for confirmation before deleting or moving anything.
  4. Delete only the approved files, then rerun the scan to verify the workspace is clean.
  5. When reorganizing files, group them by extension into clearly named folders and report every move.

© bonigarcia, Apache-2.0. 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 ch04/agent-skills/workspace-analyzer of bonigarcia/context-engineering.

Open the folder on GitHubat commit fe02d5e

Compare with similar skills

Workspace Analyzer 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.

Workspace Analyzer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workspace Analyzer this skillbonigarcia/context-engineering164—~175Automated safety check: PassApache-2.0
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence
Context Mode for Antigravity CLImksglu/context-mode26k—~850Automated safety check: PassCustom licence
Base HelpChristopherKahler/base290—~2.6kAutomated safety check: PassCustom licence
LemmalogJordyZomer/lemmalog329—~2.8kAutomated safety check: PassMIT
Cortex Mem MCPsopaco/cortex-mem313—~2.8kAutomated safety check: PassMIT

Similar skills

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Routing rules for using context-mode MCP tools in Antigravity CLI: sandboxed code runs, file analysis, indexed search and web fetches that keep large output out of the conversation.

    26k GitHub stars~850 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Base Help

    ChristopherKahler/base

    Coach mode for the base CLI: teaches what to do and why, rather than just answering.

    290 GitHub stars~2.6k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Lemmalog

    JordyZomer/lemmalog

    Externalize working memory and logical state into the lemmalog Datalog engine (MCP).

    329 GitHub stars~2.8k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Cortex Mem MCP

    sopaco/cortex-mem

    Persistent memory enhancement for AI agents. An agent skill from sopaco/cortex-mem.

    313 GitHub stars~2.8k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • MCP Code Search Tool Selection

    Context-Engine-AI/Context-Engine

    Rules for choosing Qdrant-Indexer semantic search over grep or file reads when exploring code, debugging or asking where and why questions.

    402 GitHub stars~1.3k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed

Categories

Questions about Workspace Analyzer

What does Workspace Analyzer do?

Inspect a workspace, identify temporary files, and perform only approved cleanup or organization steps. Workspace Analyzer is an agent skill from bonigarcia/context-engineering. Inspect a workspace, identify temporary files, and perform only approved cleanup or organization steps.

When should I use Workspace Analyzer?

Workspace Analyzer fits situations like: tasks that involve Context engineering.

How do I install Workspace Analyzer in Claude Code?

Run `npx skills add bonigarcia/context-engineering --skill workspace-analyzer -a claude-code`. Or copy the skill folder (ch04/agent-skills/workspace-analyzer in bonigarcia/context-engineering) into .claude/skills/workspace-analyzer in your project. Claude Code loads it when a task matches its description.

How do I install Workspace Analyzer in Codex?

Run `npx skills add bonigarcia/context-engineering --skill workspace-analyzer -a codex`. Or copy the skill folder (ch04/agent-skills/workspace-analyzer in bonigarcia/context-engineering) into .agents/skills/workspace-analyzer in your project. Codex loads it when a task matches its description.

Can I use Workspace Analyzer 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 bonigarcia/context-engineering --skill workspace-analyzer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workspace-analyzer, .gemini/skills/workspace-analyzer, .github/skills/workspace-analyzer and .opencode/skills/workspace-analyzer in your project.

What does Workspace Analyzer need to run?

Going by SKILL.md and its folder, Workspace Analyzer needs the command-line tools its instructions call (git).

Does Workspace Analyzer access the network?

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

Is Workspace Analyzer 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 Workspace Analyzer use?

Workspace Analyzer is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workspace Analyzer use?

About 175 tokens (SKILL.md is roughly 700 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 Workspace Analyzer?

Skills that share tags, products or a category with Workspace Analyzer: Context Mode Output Sandbox (mksglu/context-mode, 26k stars), Context Mode for Antigravity CLI (mksglu/context-mode, 26k stars), Base Help (ChristopherKahler/base, 290 stars) and Lemmalog (JordyZomer/lemmalog, 329 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workspace Analyzer?

bonigarcia (a GitHub user) maintains it in bonigarcia/context-engineering, which has 164 GitHub stars. The repository was last updated on October 9, 2026.

Source: bonigarcia/context-engineering on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.