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.