Can it optimize my existing project instructions?

Yes, Claude MD Architect can analyze your current CLAUDE.md to find redundancies, outdated commands, and 'generic fluff' that wastes tokens.

What is a CLAUDE.md file?

A CLAUDE.md file is a specialized configuration file used by Claude Code to understand your project's specific rules, build commands, testing strategies, and architectural patterns.

Why use CLAUDE.md instead of just a README?

While a README is designed for human onboarding, a CLAUDE.md is optimized for AI consumption, focusing on the specific constraints and instructions Claude needs to write compatible code.

How does this skill reduce token usage?

It refactors verbose descriptions into concise, structured formats and identifies which context should be loaded on-demand rather than being auto-loaded into every prompt.

Does it support monorepos or multi-service projects?

Yes, it includes specialized templates for monorepos, web apps, backend APIs, and CLI tools, ensuring the guidance is tailored to the project's complexity.

Claude MD Architect

Name: Claude MD Architect
Author: samhvw8

bysamhvw8

•

Developer Tools

Generates and optimizes CLAUDE.md files to improve project context and reduce token usage for Claude Code.

Claude MD Architect is a specialized skill designed to streamline the interaction between developers and Claude Code by creating high-performance CLAUDE.md files. By analyzing your codebase's unique structure, frameworks, and coding standards, it generates concise project instructions that minimize token consumption while maximizing AI effectiveness. Whether you are initializing a new repository or refactoring existing documentation, this skill applies Anthropic's engineering best practices to ensure Claude understands your project's specific needs without unnecessary fluff or redundant information.

Key Features

01Token usage optimization through concise, evidence-based patterns

02Codebase-aware CLAUDE.md generation based on actual file structure

03Automatic extraction of project-specific commands and style guides

04Implementation of Anthropic's engineering and prompting best practices

051 GitHub stars

06Smart context-loading strategies using advanced @-syntax patterns

Use Cases

01Bootstrapping a new project with optimized Claude Code instructions

02Refactoring a bloated CLAUDE.md file to save tokens and improve AI response speed

03Standardizing documentation across multiple repositories for team-wide Claude Code usage

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add samhvw8/dot-claude claude-md-architect

For use in Claude.ai and ChatGPT

Download Skill