merge-docs

Consolidate design and implementation docs into a unified specification with a prioritized task list.

147|31|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/serpro69/claude-toolbox --skill merge-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: merge-docs
Source: https://github.com/serpro69/claude-toolbox/tree/main/kodex-plugin/skills/merge-docs
Command: npx skills add https://github.com/serpro69/claude-toolbox --skill merge-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidates competing or complementary design and implementation docs into a single, unified feature specification.

Core Features & Use Cases

  • Unified design schema: merges multiple design documents into a coherent design.md.
  • Implementation alignment: ensures implementation docs reflect the merged design decisions.
  • Guided merge workflow: provides step-by-step guidance for resolving contradictions and gaps between sources.

Quick Start

Copy the two feature doc directories into the tool to generate a merged design and implementation package.

Frequently Asked Questions about merge-docs

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

FAQPage Schema
How do I merge competing design docs into a single feature spec?▼

Merging competing design docs involves consolidating multiple feature documents into a unified specification. The tool applies a guided workflow to resolve contradictions, producing a merged design, merged implementation, and a prioritized task list.

What is the best way to reconcile gaps between implementation docs before coding?▼

Reconciling gaps between implementation docs requires aligning them with merged design decisions. The tool provides a guided workflow to resolve contradictions, ensuring implementation documents accurately reflect the unified feature specification before coding begins.

Can I combine two complementary feature design documents into one coherent design file?▼

Yes, you can combine complementary feature design documents into a single coherent design file. The tool merges multiple source documents into a unified design schema, resolving overlaps to produce a consolidated design specification.

Does the merge workflow provide a task list for implementation?▼

Yes, the merge workflow provides a prioritized task list for implementation. It consolidates competing docs into a merged design and implementation package, outputting a review-ready list of prioritized tasks to guide subsequent coding efforts.

When do I need to consolidate multiple feature specifications?▼

You need to consolidate multiple feature specifications when you have competing or complementary docs requiring reconciliation before coding. This ensures implementation aligns with a single unified design schema and avoids conflicting development efforts.