Claude MarketplacesSubmit
samhvw8 avatar

Claude Md Architect

samhvw8/dot-claude

Generates and optimizes CLAUDE.md files for your projects by analyzing your actual codebase and applying Anthropic's best practices. The workflow is simple: point it at a new or existing project, and it'll create concise project instructions that maximize Claude Code effectiveness while keeping token usage lean. It's opinionated about token efficiency, pushing you toward 250 lines or less with concrete guidance on what to keep versus what to cut. Handles everything from initial setup to refactoring bloated instruction files, with specific templates for web apps, APIs, CLI tools, and libraries. Worth using if you're tired of generic CLAUDE.md files or wondering why yours spans 800 lines of fluff.

skills.sh installs
153
GitHub stars
11
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add samhvw8/dot-claude --skill claude-md-architect --agent claude-code

Installs into .claude/skills of the current project.

Files

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

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/samhvw8/dot-claude
Categories
Code Review & Quality, AI & Agent Building
First seen
Jun 3, 2026

More from samhvw8/dot-claude

All 4

Recommended

More Code Review & Quality
1jabrena avatar141-java-refactoring-with-modern-featuresjabrena/cursor-rules-java141 java refactoring with modern features135skills.sh installs
2buiducnhat avataras-reviewbuiducnhat/agent-skillsas review131skills.sh installs
3getsentry avatarcode-reviewgetsentry/sentry-skillscode review125skills.sh installs
4leeovery avatarlaravel-qualityleeovery/claude-laravellaravel quality116skills.sh installs
5agentscope-ai avatarpaper-reviewagentscope-ai/openjudge>0skills.sh installs
6angular avatarPR Reviewangular/angularGuidelines and tools for reviewing pull requests in the Angular repository.0skills.sh installs