alirezarezvani/claude-code-skill-factory / generated-skills/claude-md-enhancer
claude-md-enhancer
VerifiedAnalyzes, 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.
| File | Kind | Size |
|---|---|---|
| HOW_TO_USE.md | markdown | 12.2 KB |
| README.md | markdown | 15.8 KB |
| SKILL.md | skill md | 16.1 KB |
| analyzer.py | script | 12.9 KB |
| examples/README.md | markdown | 5.3 KB |
| examples/core-small-team-CLAUDE.md | markdown | 5.5 KB |
| examples/minimal-solo-CLAUDE.md | markdown | 1.8 KB |
| examples/modular-backend-CLAUDE.md | markdown | 9.1 KB |
| examples/modular-frontend-CLAUDE.md | markdown | 10.5 KB |
| examples/modular-root-CLAUDE.md | markdown | 6.4 KB |
| examples/python-api-CLAUDE.md | markdown | 13.0 KB |
| expected_output.json | config | 9.8 KB |
| generator.py | script | 19.1 KB |
| sample_input.json | config | 4.4 KB |
| template_selector.py | script | 16.7 KB |
| validator.py | script | 14.9 KB |
| workflow.py | script | 15.5 KB |
sample_input.json
View on GitHub{
"examples": [
{
"scenario": "initialize_new_project",
"description": "Interactive initialization workflow for new project without CLAUDE.md",
"input": {
"mode": "initialize",
"exploration_results": {
"files": ["package.json", "tsconfig.json", "README.md", ".github/workflows/ci.yml"],
"directories": ["src", "backend", "frontend", "tests", ".github/workflows"],
"file_contents": {
"package.json": "{\"dependencies\": {\"react\": \"^18.0.0\", \"typescript\": \"^5.0.0\", \"express\": \"^4.18.0\"}}",
"README.md": "# Full-Stack TypeScript Project"
}
},
"user_confirmation": "yes"
}
},
{
"scenario": "analyze_existing",
"description": "Analyze an existing CLAUDE.md file for quality and completeness",
"input": {
"mode": "analyze",
"content": "# CLAUDE.md\n\nThis is a basic CLAUDE file.\n\n## Tech Stack\n- TypeScript\n- React\n- Node.js\n\n## Workflow\n- Use Git for version control\n- Write tests\n\n",
"project_context": {
"type": "web_app",
"tech_stack": ["typescript", "react", "node"],
"team_size": "small",
"phase": "mvp"
}
}
},
{
"scenario": "create_new_fullstack",
"description": "Create new CLAUDE.md for a full-stack TypeScript project",
"input": {
"mode": "create",
"project_context": {
"type": "fullstack",
"tech_stack": ["typescript", "react", "node", "postgresql", "docker"],
"team_size": "small",
"phase": "mvp",
"workflows": ["tdd", "cicd", "documentation_first"]
},
"modular": true,
"subdirectories": ["backend", "frontend", "database"]
}
},
{
"scenario": "enhance_with_missing_sections",
"description": "Enhance existing file by adding missing sections",
"input": {
"mode": "enhance",
"content": "# CLAUDE.md\n\n## Core Principles\n1. Write tests first\n2. Use TypeScript\n\n## Tech Stack\n- TypeScript\n- React\n- PostgreSQL\n",
"project_context": {
"type": "web_app",
"tech_stack": ["typescript", "react", "postgresql"],
"team_size": "medium",
"phase": "production"
},
"add_sections": ["Testing Requirements", "Error Handling Patterns", "Performance Guidelines"]
}
},
{
"scenario": "create_modular_architecture",
"description": "Create modular CLAUDE.md setup for large team",
"input": {
"mode": "create",
"project_context": {
"type": "api",
"tech_stack": ["python", "fastapi", "postgresql", "redis", "docker", "kubernetes"],
"team_size": "large",
"phase": "enterprise",
"workflows": ["tdd", "cicd", "agile"]
},
"modular": true,
"subdirectories": ["backend", "database", "docs", ".github"]
}
},
{
"scenario": "validate_existing",
"description": "Validate existing CLAUDE.md against best practices",
"input": {
"mode": "validate",
"content": "# CLAUDE.md\n\nGuidance for development.\n\n## Core Principles\n\n1. Code quality matters\n2. Test everything\n3. Document changes\n\n## Tech Stack\n\n- React 18\n- TypeScript 5\n- Node 20\n- PostgreSQL 15\n\n## Workflow Instructions\n\n### Development Process\n\n1. Create feature branch\n2. Write tests\n3. Implement feature\n4. Create PR\n5. Code review\n6. Merge to main\n\n## Testing Requirements\n\n- Unit tests for all business logic\n- Integration tests for API endpoints\n- E2E tests for critical user flows\n- Minimum 80% code coverage\n\n## Error Handling\n\n- Use try-catch blocks\n- Log errors with context\n- Return meaningful error messages\n- Never expose sensitive data\n\n",
"project_context": {
"type": "fullstack",
"tech_stack": ["typescript", "react", "node", "postgresql"],
"team_size": "small",
"phase": "production"
}
}
},
{
"scenario": "generate_context_specific",
"description": "Generate backend-specific CLAUDE.md file",
"input": {
"mode": "generate_context",
"context": "backend",
"project_context": {
"type": "api",
"tech_stack": ["python", "fastapi", "postgresql"],
"team_size": "small",
"phase": "mvp"
}
}
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |