Can it update Mermaid diagrams?

Yes, it can generate and surgically update Mermaid flowcharts, including precise citations that link diagram nodes to specific file paths and line numbers.

What is the Knowledge skill for?

It automates the process of extracting information from development discussions to update project documentation and architecture diagrams.

How does it verify information accuracy?

The skill cross-references claims found in threads against the actual codebase using tools like GKG search and code definitions to ensure docs match the reality of the code.

Does it overwrite my existing documentation?

No, it performs surgical updates using the edit_file tool, preserving your existing document structure, voice, and patterns while only adding or correcting specific details.

What files does this skill typically update?

It is designed to update Markdown-based documentation, specifically targeting ARCHITECTURE.md, AGENTS.md, and skill-specific documentation within a repository.

Knowledge Extractor & Doc Sync

Name: Knowledge Extractor & Doc Sync
Author: draphonix

bydraphonix

•

Content Management

Extracts technical knowledge from development threads to keep project documentation and architecture diagrams synchronized with the codebase.

About

This skill automates the tedious process of maintaining up-to-date documentation by analyzing development threads, verifying changes against the actual codebase, and performing surgical updates to documentation files. It helps teams bridge the gap between developer discussions and formal documentation, ensuring that architecture guides, AGENTS.md files, and Mermaid diagrams accurately reflect the current state of the project. By using parallel extraction agents and an Oracle reconciliation phase, it identifies stale content and missing documentation gaps with high precision.

Key Features

49 GitHub stars
Automated Gap Analysis: Identifies missing documentation or stale content by comparing threads, code, and existing docs.
Code Verification: Cross-references thread claims with the actual codebase using GKG and semantic search tools.
Architecture Visualization: Automatically generates and updates Mermaid diagrams with specific source code citations.
Parallel Extraction: Orchestrates multiple task agents to process large thread histories simultaneously for efficiency.
Thread Discovery: Search for specific topics or timeframes in development history using advanced filters.

Use Cases

Updating AGENTS.md or architecture guides based on technical decisions made in recent communication threads.
Synchronizing project documentation immediately after completing a major development epic or sprint.
Generating technical summaries and diagrams for complex refactors to assist in team handovers.

About

Key Features

49 GitHub stars
Automated Gap Analysis: Identifies missing documentation or stale content by comparing threads, code, and existing docs.
Code Verification: Cross-references thread claims with the actual codebase using GKG and semantic search tools.
Architecture Visualization: Automatically generates and updates Mermaid diagrams with specific source code citations.
Parallel Extraction: Orchestrates multiple task agents to process large thread histories simultaneously for efficiency.
Thread Discovery: Search for specific topics or timeframes in development history using advanced filters.

Use Cases

Updating AGENTS.md or architecture guides based on technical decisions made in recent communication threads.
Synchronizing project documentation immediately after completing a major development epic or sprint.
Generating technical summaries and diagrams for complex refactors to assist in team handovers.