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.

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

0149 GitHub stars

02Automated Gap Analysis: Identifies missing documentation or stale content by comparing threads, code, and existing docs.

03Code Verification: Cross-references thread claims with the actual codebase using GKG and semantic search tools.

04Architecture Visualization: Automatically generates and updates Mermaid diagrams with specific source code citations.

05Parallel Extraction: Orchestrates multiple task agents to process large thread histories simultaneously for efficiency.

06Thread Discovery: Search for specific topics or timeframes in development history using advanced filters.

Use Cases

01Updating AGENTS.md or architecture guides based on technical decisions made in recent communication threads.

02Synchronizing project documentation immediately after completing a major development epic or sprint.

03Generating technical summaries and diagrams for complex refactors to assist in team handovers.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add draphonix/skills knowledge

For use in Claude.ai and ChatGPT

Download Skill