skill-zipper

Restructure Claude Code skills with five lossless operations and token delta reports.

5|Updated Jun 5, 2026
One-click install
npx skills add https://github.com/VincentJiang06/skills --skill skill-zipper
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-zipper
Source: https://github.com/VincentJiang06/skills/tree/main/skills/skill-zipper
Command: npx skills add https://github.com/VincentJiang06/skills --skill skill-zipper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tiktoken, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

Skills degrade as they grow: bloated always-loaded content wastes tokens on every invocation, vague rules lead to inconsistent model behavior, and poor frontmatter descriptions cause mis-triggering or complete failure to load. This skill performs a lossless restructuring that trims size, tightens instructions, and fixes triggering without changing what the skill does.

Core Features & Use Cases

  • Lossless Restructuring: Compresses and reorganizes skill content while preserving every line of behavior and instruction, verified by diff scripts.
  • Token Efficiency: Moves content to on-demand files and removes model-known redundancy to reduce always-loaded token cost.
  • Trigger Accuracy: Rewrites the frontmatter description using a rubric to ensure the skill loads on the right turns and skips irrelevant ones.
  • Portability Audit: v2.0 includes a checklist to align skills with the open standard's portable core fields for cross-runtime compatibility.

Quick Start

Use the skill-zipper skill to restructure the attached skill directory for better token efficiency and trigger accuracy.

Frequently Asked Questions about skill-zipper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce token usage in Claude Code skills without losing functionality?▼

To reduce token usage losslessly, restructure skills by moving always-loaded content to on-demand files and removing model-known redundancy. This compression trims size while preserving every instruction, verified by a diff script.

Why does my Claude Code skill fail to trigger or load on the right turns?▼

Skills fail to trigger due to poor frontmatter descriptions. You can fix trigger accuracy by rewriting the description using a specific rubric, ensuring the skill loads on relevant turns and skips irrelevant ones without altering behavior.

What is lossless skill restructuring for token efficiency?▼

Lossless skill restructuring is the process of compressing and reorganizing skill content to reduce token costs without changing behavior. It applies operations like encapsulate, enrich, and harden, producing a token delta report and a diff proof.

Can I audit my Claude Code skills for cross-runtime portability?▼

Yes, you can audit cross-runtime portability by applying a checklist that aligns your skills with the open standard's portable core fields. This ensures compatibility across different runtimes while restructuring content for reliability.

Do I need tiktoken to restructure skills for trigger accuracy and compression?▼

Yes, tiktoken is required as a dependency to measure token efficiency accurately. It calculates the token delta report, enabling you to verify that content compression and progressive disclosure effectively reduce always-loaded token cost.

What's the best way to fix vague instructions in Claude Code skills?▼

The best way to fix vague instructions is to apply enrichment and hardening operations during skill restructuring. This tightens rules to ensure consistent model behavior while generating a lossless diff proof to verify no instructions were lost.