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.