agentsclimarketplace

Tool audit

Skill onur-gokyildiz-bhi/codescope/.claude/skills/tool-audit

Audit MCP tool set — count, descriptions, consolidation candidates, budget compliance.From its SKILL.md

Install
npx -y skills add onur-gokyildiz-bhi/codescope --skill tool-audit

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.0 KB, as published. Nobody here has run it

/tool-audit

Verify the MCP tool surface is within budget and well-described. Dewey's periodic audit.

When to invoke

  • Before a release (Hopper checks in with Dewey)
  • After adding new tools
  • Periodically to catch description creep
  • When an agent complains "too many tools, can't pick"

Checks

1. Tool count ≤ 40

grep -c '#\[tool(' crates/mcp-server/src/tools/*.rs | awk -F: '{sum+=$2} END {print "Total tools:", sum}'

Budget: 40 max. Current target: ≤ 32.

If over budget:

  • List all tools: grep -B1 'async fn ' crates/mcp-server/src/tools/*.rs | grep 'async fn' | sed 's/.*async fn //; s/(.*//' | sort
  • Identify consolidation candidates (similar semantics, overlapping params)
  • Consult Dewey agent for consolidation plan

2. Description length ≤ 100 chars per tool

grep -B5 'async fn ' crates/mcp-server/src/tools/*.rs | grep 'description = "' | awk -F'description = "' '{print length($2)-2, $2}' | sort -rn | head -10

Any line starting with a number > 100 is over budget.

3. Description keyword quality

For each tool description, check:

  • First 50 chars answer "WHAT does it do?"
  • Has concrete domain keywords the model can match
  • Disambiguates from similar tools

4. Consolidation candidates

Look for tool pairs where descriptions differ in <3 keywords — those are merge candidates.

Output format

Report markdown:

## Tool Audit (YYYY-MM-DD)

**Total tools:** N / 40 ✅
**Descriptions over 100 chars:** 0 ✅

### Tools by file
...

### Consolidation candidates
- tool_a + tool_b — both search-related, could be merged

### Breaking change budget
Next release: patch / minor / major

Codescope-first rule

  • search(mode="fuzzy", query="#\\[tool(") to see all tool declarations in context
  • knowledge(action="search", query="tool consolidation") for historical decisions

Keep looking

Skills are one crate of 613,297. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.