merge-reference-docs

Merge external reference Markdown files into project documentation while preserving frontmatter and structure.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/linnefromice/claude-code-workspace --skill merge-reference-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: merge-reference-docs
Source: https://github.com/linnefromice/claude-code-workspace/tree/main/template-.claude/skills/custom-samples/merge-reference-docs
Command: npx skills add https://github.com/linnefromice/claude-code-workspace --skill merge-reference-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill merges external reference Markdown files into your project's own documentation to extend and update agent, skill, and rule definitions with consistent guidance.

Core Features & Use Cases

  • Reference consolidation: Merge multiple reference files into the target project docs while preserving project-specific structure.
  • Guideline alignment: Normalize terminology and rules across documents to maintain a single source of truth.
  • Use Case: On a new project, merge best-practice references into local agent definitions to accelerate onboarding and setup.

Quick Start

Use the merge-reference-docs skill to combine a base reference with project-specific files. Example: /merge-reference-docs @{target} @{reference1} [@{reference2} ...] type={agent|skill|rule}

Frequently Asked Questions about merge-reference-docs

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

FAQPage Schema
How do I merge multiple markdown reference files into one project document?

To merge markdown reference files, use the merge-reference-docs skill to combine external guides into project-specific documentation while preserving the target structure and frontmatter. It harmonizes best practices across multiple documents to maintain a single source of truth for project governance.

What is the best way to consolidate external reference guides with existing agent definitions?

Consolidating external reference guides with existing agent definitions involves merging the reference markdown into your local project files. This skill normalizes terminology and rules across documents, extending your agent definitions with consistent guidance without losing project-specific structure.

Can I preserve frontmatter when merging markdown documentation?

Yes, you can preserve frontmatter when merging markdown documentation. The merge process specifically protects the target document's frontmatter and structural formatting while optionally incorporating the content from the external reference files during the consolidation.

How do I keep a single source of truth when updating project rules and skills?

Keeping a single source of truth for project rules and skills requires harmonizing best practices across multiple documents. By merging external reference files into your target project documentation, you normalize terminology and align guidelines to prevent conflicting rule definitions.

Does the markdown merge process support multiple reference files at once?

Yes, the markdown merge process supports multiple reference files at once. You can provide one target file followed by multiple reference files as inputs, allowing you to consolidate several external best-practice guides into a single project document simultaneously.