Skip to content

Instantly share code, notes, and snippets.

@Shehryar
Shehryar / SKILL_CLI_ARCHITECTURE.md
Created February 26, 2026 19:46
Dumb CLI + Skill Prompt: an architecture for giving AI agents tool access without context bloat

Skill CLI Architecture

Problem

AI agents (Claude Code, Claude Desktop, custom apps) suffer from context bloat when many tools are loaded. MCP servers don't solve this - they just organize where tools come from, but all tool definitions still get injected into every conversation.

Solution: Dumb CLI + Skill Prompt

The recommended pattern is a "dumb" CLI (pure API wrapper, no AI) combined with a Claude Code skill prompt that teaches Claude how to use it.