When should I use Skill Optimizer?

Use it whenever a skill file exceeds 5KB, becomes difficult to maintain, or when you notice high token consumption during simple tasks.

Does this change the skill's functionality?

No, the skill preserves all original capabilities while reorganizing them into a more efficient structure for better performance and easier maintenance.

How much can I save on token costs?

By moving from monolithic skills to the orchestrator pattern, users typically see a token reduction between 80% and 95% per request.

What is Progressive Disclosure Architecture (PDA)?

PDA is a design pattern that keeps the main skill file small and lightweight, loading detailed documentation or specialized logic only when the specific context requires it.

What files does it create?

It typically creates a reference/ directory for deep documentation and a scripts/ directory for mechanical or repetitive logic.

Skill Optimizer

Name: Skill Optimizer
Author: jovermier

byjovermier

0•

生产力与工作流

Refactors Claude Code skills using Progressive Disclosure Architecture to reduce token consumption by up to 95%.

Skill Optimizer is a specialized utility designed to transform bloated or monolithic Claude Code skills into efficient, high-performance tools. By implementing Progressive Disclosure Architecture (PDA), it splits large instruction sets into a lightweight orchestrator supported by modular reference files and external scripts. This approach significantly lowers token costs, improves skill maintainability, and enhances detection accuracy through optimized metadata and trigger coverage.

主要功能

01Automated extraction of API docs, examples, and scripts into specialized directories

02Metadata and YAML frontmatter optimization for better skill discovery

03Token usage reduction of 80-95% via on-demand content loading

040 GitHub stars

05Standardized refactoring patterns including Encyclopedia to Orchestrator and Domain Split

06Progressive Disclosure Architecture (PDA) implementation for modular skill design

使用场景

01Optimizing skill metadata to ensure Claude triggers the right tools for specific user requests

02Reducing operational costs and token usage for large, complex AI coding skills

03Refactoring legacy monolithic skills into maintainable, modular architectures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jovermier/claude-code-plugins-ip-labs skill-optimizer

For use in Claude.ai and ChatGPT

Download Skill