How does it decide where to move the content?

It uses semantic matching to find the best existing documentation file and applies fallback mappings to create new ADRs, plans, or migration guides if no match is found.

Does this skill delete my files without permission?

No. It follows a two-phase workflow where it first presents a consolidation plan for your approval before performing any merges or deletions.

Can I use Doc Consolidation as part of my PR workflow?

Yes, it is designed to integrate with skills like pr-prep to ensure all valuable insights are documented and temporary artifacts are removed before code is merged.

What types of files does Doc Consolidation process?

The skill identifies untracked markdown files that contain LLM markers like 'Executive Summary' or 'Findings,' typically named as *_REPORT.md or *_ANALYSIS.md.

What merge strategies does the skill use?

It uses Intelligent Weave for additive content, Replace Section for more comprehensive updates, and Append with Context when no direct section match exists.

Doc Consolidation

Name: Doc Consolidation
Author: athola

byathola

•

Learning & Documentation

Extracts insights from temporary LLM-generated reports and merges them into permanent documentation to preserve project knowledge and maintain git hygiene.

Doc Consolidation solves the problem of 'documentation drift' by capturing valuable insights often lost in ephemeral markdown files generated during AI coding sessions. The skill intelligently scans your workspace for untracked reports—such as API reviews, refactoring analyses, or audit logs—and categorizes their content into actionable items, decisions, and findings. By employing a two-phase workflow of triage and execution, it allows you to review a consolidation plan before automatically weaving content into existing docs, generating new Architecture Decision Records (ADRs), or updating migration guides, ensuring your project's permanent record stays comprehensive while your workspace remains clean.

Key Features

01Automated detection of untracked LLM-generated markdown files and report markers

02Semantic routing to match extracted insights with the most relevant existing documentation

0310 GitHub stars

04Intelligent content categorization for ADRs, API changes, and migration guides

05Automated cleanup of temporary source files after successful knowledge transfer

06Multiple merge strategies including Intelligent Weave, Append, and Section Replacement

Use Cases

01Maintaining a clean git workspace by moving untracked analysis logs into official documentation

02Converting temporary refactoring reports into permanent project architecture documentation

03Preserving code review insights and action items before committing a pull request

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add athola/claude-night-market doc-consolidation

For use in Claude.ai and ChatGPT

Download Skill