grandcamel

Optimizing Skills Performance — Security skill for Claude Code

Security community

Audit and optimize AI agent skills for token efficiency using progressive disclosure principles.

How to install Optimizing Skills Performance

This entry records only its repository, not the path inside it, so there is no exact command to give. Open grandcamel/optimizing-skills-performance and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Optimizing Skills Performance does

Audit and optimize AI agent skills for token efficiency using progressive disclosure principles.

Alternatives in Security

  • Query Token Audit — Audit token security to detect scams, honeypots, and malicious contracts across BSC, Base, Solana, and Ethereu 483 ★
  • Reflexion — Audit and optimize the .claude/ ecosystem — skills, hooks, guides, patterns, agents, and settings — for qualit 224 ★
  • Loongsuite Pilot — Local-first telemetry collector for AI coding agents — unified OpenTelemetry events for Claude Code, Codex, Cu 150 ★

README

The Power of Progressive Disclosure: A Timeless UX Principle

Platform Plugin License Model

Skills Performance Optimizer

Audit and optimize AI agent skills for token efficiency using a 40-year-old design principle.


The Problem: Context is the Bottleneck

In an exploratory study of coding agents, researchers found that **token consumption for the same task ranged from 8,500 to over 190,000 tokens**—a 22x difference. The variable? How efficiently agents load context.

AI coding agents need to understand vast codebases comprising thousands of files and millions of lines of code. But the model's attention—its context window—is a finite and expensive resource. You cannot simply feed an entire codebase into a prompt.

**The quality of the code an agent generates is directly determined by the relevance of the code it can "see."**


The Solution: A 40-Year-Old Design Principle

In 1981, designers at Xerox PARC faced a similar challenge: how to make powerful systems accessible without overwhelming users with complexity. Their answer was **progressive disclosure**—a principle that dictates:

*"Detail should be hidden from users until they ask or need to see it."*

Decades later, psychology proved them right. Research on algorithmic transparency found that detailed, incremental feedback was often *counterproductive*—distracting users, exposing minor errors that