Skip to content

navveenb/lean-agentic-ai / lean-agentic-ai-claude-implementation/.claude/skills/bloat-detector

bloat-detector

Verified

Detect the 7 types of agentic bloat in a codebase or system design

FileKindSize
SKILL.mdskill md2.7 KB
---
name: bloat-detector
description: Detect the 7 types of agentic bloat in a codebase or system design
user-invocable: true
argument-hint: [file-or-directory-path]
allowed-tools: Read, Grep, Glob, Write
model: sonnet
---

# Bloat Detector

Scan a codebase or system description for the 7 types of agentic bloat and produce a scored audit.

## Lean Principle

- [x] #1 Context is a liability
- [x] #2 Right-size your model
- [x] #3 Orchestration is not a playground
- [x] #4 Reflections cost compute
- [x] #5 RAG isn't always right
- [x] #7 Reuse over recompute
- [x] #8 More tools, more problems

## Instructions

### Step 1: Scan for each bloat type

Use Grep and Read to look for evidence of these 7 bloat patterns:

**1. Model Bloat** — Look for hardcoded frontier model names (`gpt-4`, `claude-opus`, `gemini-ultra`) used for simple tasks (classification, extraction, formatting).

**2. Orchestration Bloat** — Count distinct agent definitions, multi-agent chains, sequential agent invocations. Flag if more than 3 agents are chained sequentially.

**3. Reflection Bloat** — Look for self-critique patterns: "review your output", "improve your answer", retry loops, `while` loops around LLM calls without exit conditions.

**4. Context Bloat** — Look for large system prompts (>2000 chars), full document injection, unbounded conversation history loading, many tool descriptions.

**5. Tool Bloat** — Count tool/function definitions per agent. Flag agents with more than 5 tools.

**6. Memory Bloat** — Look for unbounded storage: missing TTLs, "store everything", no cleanup/expiry logic, full transcript storage.

**7. Retrieval Bloat** — Look for RAG pipelines that run on every query without gating: always-on vector search, no relevance thresholds, no caching of retrieval results.

### Step 2: Score each category

Score each bloat type 0-3:
- 0 = No evidence of bloat
- 1 = Minor (some instances, manageable)
- 2 = Moderate (multiple instances, should optimize)
- 3 = Severe (systemic, causing significant waste)

### Step 3: Write report

Write a report to `reports/bloat-audit.md` with:
- Score per category (0-3)
- Total score out of 21
- Specific file:line references for each finding
- Severity rating: 0-5 Lean, 6-12 Moderate bloat, 13-21 Severe bloat
- Top 3 recommended fixes

## Output

Report saved to `reports/bloat-audit.md`

## Example

Input: A project with 5 chained agents all using GPT-4, no caching, 10 tools per agent.
Output:
```
Model Bloat: 3/3 — All 5 agents use frontier model for mixed tasks
Orchestration Bloat: 2/3 — 5 agents chained, 2 could be merged
Tool Bloat: 3/3 — 10 tools per agent, most unused
Total: 15/21 — SEVERE bloat. Start with model routing and tool pruning.
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall