What is the purpose of the guardian agent?

The claude-md-guardian agent is designed for ongoing maintenance; it detects when you've made significant changes to the codebase and offers to synchronize your documentation automatically.

How does the CLAUDE.md quality score work?

The skill scans your existing file for essential sections like setup instructions, build commands, and architectural notes, assigning a score from 0-100 based on completeness and clarity.

What is native format compliance for CLAUDE.md?

Native format compliance ensures your CLAUDE.md follows the specific structure Claude Code expects, including optimized project diagrams, specific command sections, and architecture definitions for maximum context efficiency.

Can this skill handle mono-repos or modular projects?

Yes, the skill supports modular architecture by creating and managing context-specific CLAUDE.md files for sub-directories like backend, frontend, and database folders.

Claude.md Project Enhancer

Name: Claude.md Project Enhancer
Author: sjawhar

bysjawhar

•

Content Management

Initializes and optimizes CLAUDE.md files to provide high-quality project context through automated discovery and native format compliance.

The Enhance-Claude-MD skill streamlines your development workflow by generating or upgrading CLAUDE.md files to meet 100% native Claude Code format standards. It intelligently analyzes your repository to detect tech stacks, architecture patterns, and project structures, creating comprehensive documentation that helps AI agents understand your codebase more effectively. Whether starting a new project or maintaining a legacy one, this skill provides interactive initialization, quality scoring for existing documentation, and an automated 'guardian' agent to keep your project context synchronized after major refactors or feature updates.

Key Features

01Automated maintenance agent for context synchronization after project changes

02Modular architecture support for backend, frontend, and database-specific contexts

03100% native format compliance with official Claude Code documentation standards

04Intelligent quality scoring and gap analysis for existing CLAUDE.md files

05Interactive repository discovery and automated tech stack detection

062 GitHub stars

Use Cases

01Maintaining project context automatically after major refactors or dependency updates

02Auditing and upgrading existing project documentation to improve AI assistant accuracy

03Initializing standardized documentation for new projects to ensure immediate AI context

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sjawhar/dotfiles enhance-claude-md

For use in Claude.ai and ChatGPT

Download Skill