synthesize-tech-docs

Synthesize PRDs, design docs, and codebases into markdown engineering documentation.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Elmanuel1/skills --skill synthesize-tech-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthesize-tech-docs
Source: https://github.com/Elmanuel1/skills/tree/main/synthesize-tech-docs
Command: npx skills add https://github.com/Elmanuel1/skills --skill synthesize-tech-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Engineering documentation for new features is often incomplete, misaligned with actual implementation, or missing critical context from product and design teams, leading to confusion, onboarding delays, and miscommunication between engineering, product, and design stakeholders.

Core Features & Use Cases

  • Triple-source synthesis: Combines context from the Product Requirements Document (PRD, for business intent, scope, and success metrics), design doc (for UX flows and user intent), and actual production code (for ground truth on what was built) to create fully aligned documentation.
  • Discrepancy surfacing: Explicitly flags mismatches between planned PRD/design intent and actual code implementation, so teams can address gaps before they cause downstream issues.
  • Multiple output formats: Generates a README for engineer onboarding, an architecture/system overview for tech leads, and/or an API reference for cross-team integrators, saved as local markdown with optional Confluence publishing.
  • Use Case: When your team launches a new feature and needs documentation that explains not just what the code does, but why it was built and how it aligns with user experience design, without gaps between planned requirements and actual implementation.

Quick Start

Use the synthesize-tech-docs skill to generate complete engineering documentation for your new feature by providing the PRD file, design doc, and local or GitHub codebase path.

Frequently Asked Questions about synthesize-tech-docs

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

FAQPage Schema
How do I generate technical documentation that aligns with our PRD and actual codebase?

To generate technical documentation aligned with your PRD and codebase, synthesize your product requirements, design docs, and production code together. This process creates markdown artifacts like READMEs and architecture overviews while explicitly flagging discrepancies between planned intent and built features.

What is the best way to document discrepancies between planned design docs and actual implementation?

Documenting discrepancies between design docs and actual implementation involves triple-source synthesis. By comparing the product requirements and design documentation directly against the production codebase, you can explicitly surface mismatches in your engineering technical documentation before they cause downstream issues.

Can I generate an API reference and architecture overview from a local codebase and a design doc?

Yes, you can generate an API reference and architecture overview from a local codebase and a design doc. By requiring all three source inputs—the PRD, design doc, and codebase—the synthesis process ensures the resulting markdown artifacts capture business intent, UX flows, and actual implementation details accurately.

Do I need both a PRD and a design doc to create engineering documentation for a new feature?

Yes, both a PRD and a design doc are required to create engineering documentation for a new feature. The tool enforces that all three source inputs are present, including the production codebase, to avoid generating speculative or incomplete documentation that misses critical business intent or UX context.

How to publish generated technical documentation to Confluence?

To publish generated technical documentation to Confluence, use the optional Confluence publishing feature after synthesizing your PRD, design doc, and codebase. This produces aligned markdown artifacts such as READMEs and API references, which can then be exported directly to your Confluence workspace.

Why does my new feature documentation have gaps between user experience design and actual code implementation?

New feature documentation has gaps between user experience design and actual code implementation when generated without synthesizing all three sources. By cross-referencing the PRD, design doc, and production codebase together, the triple-source synthesis explicitly surfaces mismatches to address these discrepancies before they cause miscommunication.