Agent skill · software engineering · samhvw8
claude-md-architect
CLAUDE.md file generation and optimization for Claude Code projects. Capabilities: initialize project instructions, analyze codebase context, optimize existing CLAUDE.md, apply Anthropic best practices, reduce token usage, improve effectiveness. Actions: init, create, optimize, enhance CLAUDE.md files. Keywords: CLAUDE.md, project instructions, Claude Code setup, project context, codebase analysis, Anthropic best practices, token optimization, project configuration, AI instructions, coding guidelines, project rules, workspace setup. Use when: initializing CLAUDE.md for new projects, optimizing existing project instructions, setting up Claude Code for a codebase, improving AI coding guidelines.
Why this skill is useful
Adds specific workflows and templates for generating and optimizing CLAUDE.md files tailored to Claude Code projects, which the AI wouldn't reliably generate on its own.
What it needs
About 5k tokens when loaded. Last updated 2025-12-09. 10 stars on the source repository.
What this skill does
CLAUDE.md Architect Skill Generate and optimize CLAUDE.md files for software projects by analyzing codebase context and applying Anthropic engineering best practices. Creates concise, maintainable project instructions that maximize Claude Code effectiveness while minimizing token consumption. Core Principles 1. Conciseness over Completeness: Treat CLAUDE.md like frequently-used prompts, not exhaustive documentation 2. Evidence-Based Context: Analyze actual codebase before making recommendations 3. Incremental Refinement: Start minimal, iterate based on effectiveness 4. Token Efficiency: Every line should earn its presence in the context window 5. Human-Readable Structure: Use clear organization with XML tags for parsing When to Use This Skill Activate when user requests: "init CLAUDE.md" or "create project instructions" "optimize" or "improve" existing CLAUDE.md "setup Claude for my project" Project-specific instructions for Claude Code Starting work on a new project that needs documentation Existing CLAUDE.md is outdated or ineffective Quick Decision Tree Workflow Overview Initialize New CLAUDE.md Quick Steps: 1. Discover - Analyze codebase (language, framework, structure, tests) 2. Extract - Identify code style, commands, patterns 3. Generate - Select template, customize for project 4. Validate - Verify commands, check token count 5. Present - Show output with explanation Detailed Instructions: @refs/initialization-workflow.md Optimize Existing CLAUDE.md Quick Steps: 1. Analyze - Evaluate token efficiency, accuracy, relevance 2. Identify - Find redundancy, outdated info, generic fluff 3. Refactor - Apply token reduction, restructure, improve clarity 4. Test - Verify 40%+ token reduction, retain critical info 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills samhvw8/claude-md-architect