Analyzes, generates, and enhances CLAUDE.md files for any project type using best practices, modular architecture support, and tech stack customization. Use when setting up new projects, improving existing CLAUDE.md files, or establishing AI-assisted development standards.
Instrucciones de origen · Vista previa de solo lectura
name
claude-md-enhancer
description
Analyzes, generates, and enhances CLAUDE.md files for any project type using best practices, modular architecture support, and tech stack customization. Use when setting up new projects, improving existing CLAUDE.md files, or establishing AI-assisted development standards.
CLAUDE.md File Enhancer
This skill provides comprehensive CLAUDE.md file generation and enhancement for Claude Code projects. It analyzes existing files, validates against best practices, and generates customized guidelines tailored to your project type, tech stack, and team size.
Capabilities
🆕 Interactive Initialization: Intelligent workflow that explores your repository, detects project type and tech stack, asks for confirmation, then creates customized CLAUDE.md files
✨ 100% Native Format Compliance: All generated files follow official Claude Code format with project structure diagrams, setup instructions, architecture sections, and file structure explanations (matching /update-claude-md slash command)
Analyze Existing Files: Scan and evaluate current CLAUDE.md files for structure, completeness, and quality
Validate Best Practices: Check against Anthropic guidelines (file length, required sections, formatting standards)
Generate New Files: Create complete CLAUDE.md files from scratch for new projects
Enhance Existing Files: Add missing sections, improve structure, and update to latest best practices
Modular Architecture: Support context-specific CLAUDE.md files in subdirectories (backend/, frontend/, docs/)
Tech Stack Customization: Tailor guidelines to specific technologies (TypeScript, Python, Go, React, Vue, etc.)
Team Size Adaptation: Adjust complexity based on team size (solo, small <10, large 10+)
Template Selection: Choose appropriate template based on project complexity and development phase
Input Requirements
For Analysis and Enhancement
Provide existing CLAUDE.md file content or file path:
Complete CLAUDE.md file content or specific sections to add:
# CLAUDE.md
This file provides guidance for Claude Code when working with this project.
## Quick Navigation- [Backend Guidelines](backend/CLAUDE.md)
- [Frontend Guidelines](frontend/CLAUDE.md)
- [Database Operations](database/CLAUDE.md)
- [CI/CD Workflows](.github/CLAUDE.md)
## Core Principles1.**Test-Driven Development**: Write tests before implementation
2.**Type Safety First**: Use TypeScript strict mode throughout
3.**Component Composition**: Favor small, reusable components
4.**Error Handling**: Always handle errors with proper logging
5.**Documentation Updates**: Keep docs in sync with code changes
[... additional sections based on template ...]
How to Use
Example 1: Initialize CLAUDE.md for New Project (Interactive)
Hey Claude—I just added the "claude-md-enhancer" skill. I don't have a CLAUDE.md file yet. Can you help me create one for this project?
What Happens:
Claude checks if CLAUDE.md exists (it doesn't)
Claude explores your repository using built-in commands
Claude analyzes: project type, tech stack, team size, workflows
Claude shows discoveries and asks for confirmation
You confirm the settings
Claude creates customized CLAUDE.md file(s)
Claude enhances with best practices
Interactive Flow:
✋ User must confirm before creation
🔍 Full visibility into what was discovered
⚙️ Option to adjust settings before proceeding
Example 2: Analyze Existing CLAUDE.md
Hey Claude—I just added the "claude-md-enhancer" skill. Can you analyze my current CLAUDE.md file and tell me what's missing or could be improved?
Example 2: Generate New CLAUDE.md for TypeScript Project
Hey Claude—I just added the "claude-md-enhancer" skill. Can you create a CLAUDE.md file for my TypeScript React project with a team of 5 developers? We use PostgreSQL, Docker, and follow TDD practices.
Example 3: Enhance Existing File
Hey Claude—I just added the "claude-md-enhancer" skill. Can you enhance my existing CLAUDE.md by adding missing sections and improving the structure? Here's my current file: [paste content]
Example 4: Generate Modular Architecture
Hey Claude—I just added the "claude-md-enhancer" skill. Can you create a modular CLAUDE.md setup for my full-stack project? I need separate files for backend (Python/FastAPI), frontend (React), and database (PostgreSQL).
Initialization Workflow (New Projects)
When CLAUDE.md doesn't exist in your project, this skill provides an intelligent initialization workflow:
Workflow Steps
Step 1: Detection
Skill checks if CLAUDE.md exists in project root
If not found, initialization workflow begins
Step 2: Repository Exploration
Uses Claude Code's built-in explore command
Analyzes project structure, files, and directories
Structure Recommendation: Single file vs. modular architecture
Step 4: User Confirmation ✋
Displays all discoveries in clear format
Shows recommended CLAUDE.md structure
Asks user to confirm or adjust settings
User must explicitly approve before proceeding
Step 5: File Creation
Generates customized CLAUDE.md based on confirmed settings
Creates modular files if recommended (backend/, frontend/, etc.)
Applies tech-specific best practices
Step 6: Enhancement
Validates generated content
Adds quality improvements
Ensures completeness
Step 7: Summary
Shows what files were created
Provides next steps
Ready for immediate use
Interactive Example
User: "I need a CLAUDE.md for this project"
Claude: "I'll explore your repository first to understand the project.
[Explores using built-in commands]
Based on my exploration, here's what I discovered:
Project Type: Full-Stack Application
Tech Stack: TypeScript, React, Node.js, PostgreSQL, Docker
Team Size: Small (2-9 developers)
Development Phase: MVP
Workflows: TDD, CI/CD
Recommended Structure: Modular architecture
- Root CLAUDE.md (navigation hub)
- backend/CLAUDE.md (API guidelines)
- frontend/CLAUDE.md (React guidelines)
Would you like me to create these files?"
User: "Yes, please proceed"
Claude: "Creating customized CLAUDE.md files...
✅ Created CLAUDE.md (100 lines)
✅ Created backend/CLAUDE.md (150 lines)
✅ Created frontend/CLAUDE.md (175 lines)
Your project is ready for AI-assisted development!"
Scripts
workflow.py
Manages the interactive initialization workflow for new projects.
Key Functions:
check_claude_md_exists() - Detect if CLAUDE.md exists
generate_exploration_prompt() - Guide Claude to explore repository
CLAUDE.md Best Practices: Based on community patterns and Anthropic guidance
Example CLAUDE.md Files: See examples/ folder for 6 reference implementations covering different project types and team sizes
Version
Version: 1.0.0
Last Updated: November 2025
Compatible: Claude Code 2.0+, Claude Apps, Claude API
Remember: The goal is to make Claude more efficient and context-aware, not to create bureaucracy. Start simple, iterate based on real usage, and automate quality checks where possible.
