consolidate-skills

Consolidate multiple SKILL.md files into one SKILL.md with reference files.

2|Updated Oct 28, 2022
One-click install
npx skills add https://github.com/jmanuelrosa/dotfiles --skill consolidate-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: consolidate-skills
Source: https://github.com/jmanuelrosa/dotfiles/tree/main/.claude/skills/consolidate-skills
Command: npx skills add https://github.com/jmanuelrosa/dotfiles --skill consolidate-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidates multiple skills from a directory into a single, optimized skill that preserves distinct topics as references and eliminates redundancy, making it easier to reuse and maintain a cohesive knowledge base.

Core Features & Use Cases

  • Merges overlapping content from multiple SKILL.md files into one unified skill while maintaining separate sub-topics as reference depth.
  • Preserves depth by placing specialized topics into references/ sub-files, enabling on-demand learning without bloating the main skill.
  • Use Case: When you have several related skills covering similar domains (e.g., React patterns, testing, and performance) and want a single skill that covers the core rules plus references.

Quick Start

Provide a directory containing source skills to merge and a target topic; I will produce a consolidated Skill with a main SKILL.md and supporting references.

Frequently Asked Questions about consolidate-skills

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

FAQPage Schema
How do I merge multiple SKILL.md files into a single unified skill?

A directory containing multiple SKILL.md files with overlapping topics is required. You also provide a target topic, and the tool outputs a consolidated SKILL.md file plus supporting references.

What is the best way to consolidate overlapping skills without losing reference depth?

The best way is to map sub-topics into references/ sub-files. This preserves specialized knowledge for on-demand access while keeping the main SKILL.md focused on merged core rules.

When do I need to consolidate skills in my knowledge-management workflows?

You need to consolidate skills when you have several related skills covering similar domains. Merging eliminates redundancy and produces a cohesive, reusable knowledge base.

Does skill consolidation preserve the original architecture and frontmatter requirements?

Yes, consolidation satisfies frontmatter, topic mapping, and architecture design requirements. The phase-wise process outputs a valid SKILL.md and structured reference files.

What are the limitations of merging related skills into one optimized unit?

Merging works best with overlapping topics; unrelated skills may not fit the consolidated architecture. Specialized content is moved to references, which may fragment highly interconnected rules.