skill-organizer

Merges overlapping skills and generates a SKILL_REGISTRY.md routing guide for agent prompts.

1.1k|176|Updated Jul 18, 2025
One-click install
npx skills add https://github.com/massgen/MassGen --skill skill-organizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-organizer
Source: https://github.com/massgen/MassGen/tree/main/massgen/skills/skill-organizer
Command: npx skills add https://github.com/massgen/MassGen --skill skill-organizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

As an agent's skill library grows past roughly 50-100 entries, skill selection accuracy degrades and overlapping or near-duplicate skills accumulate. This Skill inventories all installed skills, merges redundant ones into richer parent skills, and produces a compact routing guide so agents can reliably pick the right skill.

Core Features & Use Cases

  • Skill Inventory and Analysis: Reads every SKILL.md in the skills directory to assess scope, quality, and overlap.
  • Aggressive Merging: Combines overlapping or confusable skills into hierarchical parent skills with clearly labeled sections, preserving all bundled resources.
  • Registry Generation: Writes a SKILL_REGISTRY.md grouped by domain with 'Use when' triggers and section listings, capped at 50 entries.
  • Use Case: After months of log-driven skill creation, your .agent/skills/ folder has 80 entries with duplicates like react-frontend and web-testing. Run this Skill to consolidate them into a handful of rich parent skills and a clean routing registry.

Quick Start

Organize all skills in .agent/skills/, merge any overlapping ones, and generate a SKILL_REGISTRY.md routing guide.

Frequently Asked Questions about skill-organizer

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

FAQPage Schema
How do I organize a large library of agent skills?

Inventory every skill directory, read each SKILL.md to understand scope and overlap, then merge related skills into hierarchical parent skills with labeled sections. Finish by writing a SKILL_REGISTRY.md routing guide grouped by domain with 'Use when' triggers.

How many skills can an LLM agent handle before selection degrades?

Models have a skill selection capacity of approximately 50-100 items, beyond which routing accuracy degrades. Keeping the registry under 50 entries through aggressive merging maintains reliable skill selection.

What is a SKILL_REGISTRY.md file used for?

SKILL_REGISTRY.md is a compact routing guide placed in agent system prompts. It lists each skill with a one-sentence summary, a 'Use when' trigger condition, and its internal sections, enabling agents to decide which full SKILL.md to load.

Does merging skills delete their templates and examples?

No. The merge process moves all bundled resources such as templates, examples, and configs into subdirectories of the new parent skill. Built-in skills in massgen/skills/ are only cataloged, never merged or deleted.

When should I not merge two similar skills?

Avoid merging when skills serve genuinely distinct domains or when one is a protected built-in skill. The process relies on semantic understanding of each skill's purpose rather than keyword or similarity heuristics.