Can this skill help if Claude is ignoring my instructions?

Yes, this skill is specifically designed to troubleshoot ignored instructions by optimizing the hierarchy of information and removing low-relevance content that causes instruction fatigue.

Should I include my code formatting rules in CLAUDE.md?

No, it is better to use linters and formatters. CLAUDE.md should focus on project logic and architecture while using deterministic tools to handle style enforcement.

What is the primary purpose of a CLAUDE.md file?

A CLAUDE.md file onboards Claude to your codebase at the start of every session, providing the essential context needed to understand your project's goals, tech stack, and workflows.

What is progressive disclosure in the context of Claude Code?

Progressive disclosure involves keeping CLAUDE.md lean by moving task-specific instructions (like database schemas or API rules) into separate files within an agent_docs/ folder.

Why should I keep my CLAUDE.md file short?

AI models have a limited instruction budget. Keeping the file under 300 lines ensures Claude remains focused on high-leverage information rather than getting distracted by irrelevant details.

Claude MD Authoring

Name: Claude MD Authoring
Author: hudrazine

byhudrazine

0•

学習とドキュメンテーション

Drafts and optimizes CLAUDE.md and AGENTS.md files to improve Claude Code context adherence and session performance.

The Claude MD Authoring skill provides a structured framework for creating and refining project-specific configuration files that guide Claude's behavior within a codebase. By emphasizing principles like instruction budgeting and progressive disclosure, this skill ensures that Claude receives high-leverage information—such as project goals, tech stacks, and build commands—without becoming overwhelmed by redundant or task-specific noise. It helps developers maintain a lean CLAUDE.md file by offloading secondary documentation to specialized directories, ultimately leading to more accurate code generation and fewer ignored instructions.

主な機能

010 GitHub stars

02Audits existing files for anti-patterns like redundant code style guidelines

03Standardizes CLAUDE.md structure into Why, What, and How sections

04Troubleshoots context issues by refining instruction relevance and hierarchy

05Optimizes instruction count to maintain high model performance and focus

06Implements progressive disclosure by organizing task-specific docs in agent_docs/

ユースケース

01Optimizing Claude's behavior in complex monorepos through better directory mapping

02Refactoring bloated project documentation into an AI-friendly format

03Bootstrapping a new project with a high-performance CLAUDE.md file

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hudrazine/claude-code-toolkit skills

For use in Claude.ai and ChatGPT

Download Skill