skill-extract-references

Extract logically grouped content from SKILL.md into references/ documents.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/joeloverbeck/worldloom --skill skill-extract-references
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-extract-references
Source: https://github.com/joeloverbeck/worldloom/tree/main/.claude/skills/skill-extract-references
Command: npx skills add https://github.com/joeloverbeck/worldloom --skill skill-extract-references

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The skill addresses the problem of large, bloated SKILL.md files by extracting logically grouped content into separate references/ documents, allowing for a more streamlined and manageable SKILL.md.

Core Features & Use Cases

  • Content Refactoring: Extracts large, logically grouped content blocks from SKILL.md to references/ documents.
  • Skill thinning: Rewrites SKILL.md as a thin entry point with orchestration instructions.
  • Use Case: For instance, it can refactor a complex skill's SKILL.md file by moving lengthy descriptions and procedural steps to separate reference documents, making the main skill file easier to manage and follow.

Quick Start

Refactor the skill with the following command: use skill-extract-references 'path/to/skill'.

Frequently Asked Questions about skill-extract-references

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

FAQPage Schema
How do I refactor a large Claude Code SKILL.md file?

Refactor a large SKILL.md file by extracting logically grouped content blocks into separate documents within a references directory, rewriting the main file as a thin entry point with orchestration instructions for easier management.

What is the best way to organize skill documentation when the main file gets too long?

Organize skill documentation by moving lengthy descriptions and procedural steps from the main file into separate reference documents, creating a streamlined and manageable entry point for the skill.

Can I thin out a bloated SKILL.md file without losing procedural steps?

You can thin a bloated SKILL.md file by relocating lengthy procedural steps and descriptions to separate reference documents while retaining orchestration instructions in the main file to preserve functionality.

Does refactoring skill content into references require external packages?

Refactoring skill content into references does not require external packages, as the process operates natively within the Claude Code environment by manipulating local markdown files.

When should I extract content from SKILL.md into separate reference documents?

Extract content from SKILL.md into separate reference documents when the file becomes large and bloated, making it difficult to manage and follow the core orchestration instructions.

How do I execute the skill content extraction process for a specific path?

Execute the content extraction process by running the command `use skill-extract-references 'path/to/skill'` to automatically refactor the target skill's documentation structure.