How do I optimize my skill's context window usage?

The Skill Creator recommends a 'Progressive Disclosure' design, where only essential metadata is loaded initially, while detailed documentation and scripts are loaded only when specifically needed.

What is a Claude Code Skill?

A Claude Code Skill is a modular package that extends Claude's capabilities with specialized knowledge, workflows, and tool integrations, essentially acting as an onboarding guide for a specific domain.

What files are required in a new skill?

Every skill must contain a SKILL.md file with YAML frontmatter (name and description). Optional folders include scripts/ for code, references/ for docs, and assets/ for templates.

When should I use a script versus text instructions?

Use scripts when a task requires deterministic reliability or involves repetitive code. Use text instructions when multiple approaches are valid and Claude needs to exercise judgment.

Skill Creator

Name: Skill Creator
Author: nijjaraerp

bynijjaraerp

Developer Tools

Guides the development of specialized Claude Code skills through structured blueprints and context-optimization best practices.

About

Skill Creator is a meta-skill designed to help developers build, structure, and refine custom capabilities for Claude Code. It provides a comprehensive framework for transforming Claude from a general-purpose assistant into a domain-specific agent by utilizing modular packages. By focusing on core principles like progressive disclosure and context window efficiency, this skill ensures that custom extensions are both powerful and token-efficient. It covers the entire lifecycle of skill development—from initial planning and directory structuring to final packaging—enabling users to integrate deterministic scripts, reference documentation, and reusable assets seamlessly.

Key Features

Heuristics for setting AI degrees of freedom (High vs. Low freedom)
Framework for creating modular SKILL.md files with YAML metadata
Standardized multi-step skill development workflow
0 GitHub stars
Progressive disclosure patterns to maximize context window efficiency
Guidance on organizing scripts, references, and static assets

Use Cases

Building a domain-specific AI agent for company-internal APIs
Standardizing developer workflows and boilerplate generation
Optimizing existing Claude skills to reduce token consumption

About

Key Features

Heuristics for setting AI degrees of freedom (High vs. Low freedom)
Framework for creating modular SKILL.md files with YAML metadata
Standardized multi-step skill development workflow
0 GitHub stars
Progressive disclosure patterns to maximize context window efficiency
Guidance on organizing scripts, references, and static assets

Use Cases

Building a domain-specific AI agent for company-internal APIs
Standardizing developer workflows and boilerplate generation
Optimizing existing Claude skills to reduce token consumption