What is the difference between CLAUDE.md and .llmdocs?

CLAUDE.md serves as a concise project map that is always loaded for immediate context, while .llmdocs contains detailed, concept-specific files loaded by the AI only when needed.

Does this skill overwrite my existing documentation?

No, the skill updates existing documentation incrementally and requires user validation before writing changes or removing any existing content.

How does the skill determine what needs to be updated?

It reviews your current conversation history and git diffs to identify which files and concepts were modified during your session.

Are there size limits for the documentation files?

Yes, to maintain AI efficiency, CLAUDE.md is kept under 150 lines and individual files in the .llmdocs directory are capped at 200 lines.

LLM Documentation Sync

Name: LLM Documentation Sync
Author: jimweller

byjimweller

0•

Content Management

Automates the creation and maintenance of context-rich project documentation using the CLAUDE.md and .llmdocs standards.

This skill streamlines the process of keeping project documentation synchronized with code changes by managing two distinct layers of information: a high-level CLAUDE.md 'map' for immediate context and a detailed .llmdocs 'territory' for on-demand deep dives. It automatically analyzes session history and git diffs to identify impacted documentation, proposing concise updates that ensure Claude always has access to accurate, structured technical information. By enforcing strict length limits and hierarchical referencing, it prevents context bloat while providing the AI with the specific domain knowledge and architectural patterns needed for effective coding.

Key Features

01Maintains a concise CLAUDE.md overview under 150 lines for instant project context

02Enforces strict documentation standards to ensure accuracy and prevent AI verbosity

030 GitHub stars

04Manages a modular .llmdocs directory for deep technical concepts and domain logic

05Analyzes conversation history and git diffs to identify necessary doc updates

06Provides clear summaries of modified sections and updated architectural maps

Use Cases

01Syncing high-level architectural summaries with low-level implementation details automatically

02Keeping project context updated for AI assistants after significant refactoring or feature additions

03Establishing a standardized documentation structure for new codebases to improve AI agent onboarding

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimweller/davit-dataops-dotfiles update-llm-docs

For use in Claude.ai and ChatGPT

Key Features

01Maintains a concise CLAUDE.md overview under 150 lines for instant project context

02Enforces strict documentation standards to ensure accuracy and prevent AI verbosity

030 GitHub stars

04Manages a modular .llmdocs directory for deep technical concepts and domain logic

05Analyzes conversation history and git diffs to identify necessary doc updates

06Provides clear summaries of modified sections and updated architectural maps

Use Cases

01Syncing high-level architectural summaries with low-level implementation details automatically

02Keeping project context updated for AI assistants after significant refactoring or feature additions

03Establishing a standardized documentation structure for new codebases to improve AI agent onboarding