skill-optimiser

Compress SKILL.md tokens via a deterministic 8-transform playbook with hash-based validation.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/bma-d/skill-optimiser --skill skill-optimiser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-optimiser
Source: https://github.com/bma-d/skill-optimiser/tree/main/skill-optimiser
Command: npx skills add https://github.com/bma-d/skill-optimiser --skill skill-optimiser

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Reduces the token footprint of SKILL.md files by compressing prose and consolidating structure without losing meaning, enabling faster context loading and lower cost.

Core Features & Use Cases

  • Indexify large skills into a lightweight router plus data/ files for JIT context loading.
  • Extract long procedures to scripts/ to keep SKILL.md concise and maintainable.
  • Apply a deterministic 8-transform playbook to compress format while preserving information.

Quick Start

Run the optimiser on a skill folder to produce a tighter SKILL.md with the same semantics.

Frequently Asked Questions about skill-optimiser

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

FAQPage Schema
How do I compress SKILL.md tokens to reduce context loading costs?

To compress SKILL.md tokens, apply a deterministic 8-transform playbook that consolidates structure and compresses prose without losing meaning. This reduces the token footprint, enabling faster context loading and lower costs.

What is the best way to optimize large skills for just-in-time context loading?

The best way to optimize large skills is to indexify them into a lightweight router paired with separate data files. This approach enables just-in-time context loading, ensuring only necessary information is processed at any given time.

How do I keep a SKILL.md file concise without losing procedural information?

You keep a SKILL.md file concise by extracting long procedures into dedicated scripts. This maintains the file's maintainability and reduces its token size while preserving the original procedural information.

Is it safe to run automated prose compression on installed skills?

Automated prose compression is safe because the process requires backups, uses hash-based change detection, and performs validation to prevent data loss. These controlled transformations ensure the original meaning is preserved.

Can I apply skill optimization transforms to all installed skills at once?

Yes, you can apply the optimization transforms to all installed skills simultaneously. The optimizer supports both individual skill folders and batch processing of all installed skills using the same controlled playbook.

Why do I need backups before compressing skill files?

You need backups before compressing skill files to prevent irreversible data loss during the transformation process. Hash-based change detection and validation work alongside backups to ensure format compression preserves all original information.