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.