How does this skill help reduce token usage?

It externalizes heavy Python implementations (over 20 lines) to separate files and replaces them with concise tool references, significantly lowering the context Claude must process.

Does optimization remove functionality from the skill?

No, the methodology preserves all functionality by moving logic to external modules and CLI tools while keeping core concepts and usage instructions within the main SKILL.md.

What is the recommended target length for a Claude skill?

The target for an optimized skill is typically 150-200 lines, ensuring a clear separation of concerns and efficient token budgeting.

When should I use the Skill Size Optimizer?

Use it when your SKILL.md file exceeds 300 lines, contains more than 10 similar code blocks, or triggers 'Large skill file' warnings during skills-eval validation.

Skill Size Optimizer

Name: Skill Size Optimizer
Author: Ven0m0

byVen0m0

0•

開発者ツール

Reduces Claude Code skill file size and token usage through systematic refactoring, externalization, and modularization patterns.

The Skill Size Optimizer provides a comprehensive methodology for managing complex Claude Code skills that have become bloated or inefficient. When SKILL.md files exceed 300 lines or contain excessive inline Python implementations, this skill guides developers through a multi-phase workflow to externalize heavy logic into CLI tools, consolidate repetitive patterns, and implement progressive loading. By reducing token overhead and improving file structure, it ensures that high-functionality skills remain maintainable, performant, and compliant with system validation standards.

主な機能

01Automated analysis of skill file complexity and line-count bottlenecks

02Systematic externalization of heavy Python logic into dedicated CLI tools

03Progressive loading patterns for non-essential documentation and examples

04Consolidation of redundant functions through parameterization and structured data

050 GitHub stars

06Detailed 4-phase optimization workflow from analysis to validation

ユースケース

01Transitioning monolithic skill implementations into maintainable, modular tool-based architectures

02Reducing token consumption in complex workflows to improve Claude's responsiveness

03Refactoring oversized SKILL.md files that trigger 'Large skill file' warnings

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ven0m0/claude-config optimizing-large-skills

For use in Claude.ai and ChatGPT

Download Skill