skill-compact

Prune redundant instructions from SKILL.md files using git history.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/NicoVIII/claude-config --skill skill-compact-nicoviii
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-compact
Source: https://github.com/NicoVIII/claude-config/tree/main/skills/skill-compact
Command: npx skills add https://github.com/NicoVIII/claude-config --skill skill-compact-nicoviii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the issue of documentation bloat where a skill's instructions have become overly complex, redundant, or cluttered with outdated rules, making them harder for an AI to follow effectively.

Core Features & Use Cases

  • Rule Consolidation: Merges redundant instructions into concise, high-level principles.
  • Evidence-Based Pruning: Uses git history and usage logs to identify and remove special-case rules that are no longer relevant.
  • Use Case: When a skill has grown too large to maintain or the AI starts ignoring instructions due to excessive length, use this tool to audit the file and restore clarity.

Quick Start

Run the skill-compact tool by executing the dotnet command with the target skill name and the ratio argument to analyze and shrink the documentation.

Frequently Asked Questions about skill-compact

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

FAQPage Schema
How do I shrink bloated skill documentation that an AI agent is ignoring?

Documentation bloat occurs when a skill's instructions become overly complex, redundant, or cluttered with outdated rules. Consolidating these instructions into concise, high-level principles makes them easier for an AI agent to follow effectively.

How do I clean up an AI configuration file using git history?

You can clean up an AI configuration file by using git history and usage logs for evidence-based pruning. This process identifies and removes special-case rules that are no longer relevant to the current workflow.

Why does my AI agent start ignoring instructions in a large skill file?

AI agents may ignore instructions when a skill file becomes overly complex and cluttered with outdated rules. Running a documentation optimization tool audits the file and removes redundant instructions to restore clarity.

What is the best way to consolidate redundant instructions in a SKILL.md file?

The best way to consolidate redundant instructions is to audit the SKILL.md file and merge overlapping rules into concise, high-level principles. This reduces maintenance overhead and improves AI agent adherence.

Do I need the skill-refiner binary to perform evidence-based pruning of instructions?

Yes, evidence-based pruning of the instruction set requires access to the skill-refiner binary and local git history. These dependencies provide the usage logs needed to identify and remove obsolete special-case rules.