skills.rest
rhpds
rhpdsOFFICIAL
Explore all skills by this author →
GitHub

02-writing-claude-md

Create CLAUDE.md project instruction files for Claude Code behavior.

1|Updated Apr 30, 2026
Search Tags:#automation#developer workflow#claude code#mcp#claude.md#project instructions
One-click install
npx skills add https://github.com/rhpds/claude-code-courseware --skill 02-writing-claude-md
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 02-writing-claude-md
Source: https://github.com/rhpds/claude-code-courseware/tree/main/lola/ccc/skills/02-writing-claude-md
Command: npx skills add https://github.com/rhpds/claude-code-courseware --skill 02-writing-claude-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users create CLAUDE.md files that give Claude Code persistent project guidance, reducing repeated explanations and improving consistency across development sessions.

Core Features & Use Cases

  • CLAUDE.md Fundamentals: Learn where CLAUDE.md files belong, how instruction inheritance works, and what information should be included.
  • Instruction Design Patterns: Build project conventions, workflow rules, MCP guidance, and cost-saving practices that shape Claude Code behavior.
  • Hands-On Creation: Write and validate a practical CLAUDE.md file for a real project using recommended structures and verification steps.

Quick Start

Use this skill to learn how to write a CLAUDE.md file that improves Claude Code behavior for your project.

Frequently Asked Questions about 02-writing-claude-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a CLAUDE.md file and what should I include in it for my project?▼

A CLAUDE.md file provides persistent project instructions that guide Claude Code behavior. You should include project conventions, tool preferences, automation rules, and session guidance to ensure consistent development workflows.

How do I create effective project instructions for Claude Code?▼

To create effective Claude Code project instructions, write a CLAUDE.md file using recommended structures for instruction design patterns, workflow rules, and MCP guidance, then validate the file to verify it improves development behavior.

Where should I place CLAUDE.md files to ensure instruction inheritance works?▼

CLAUDE.md files belong in specific project directories where instruction inheritance applies, allowing nested configurations to pass down persistent conventions and workflow rules across different levels of your software project.

Can I use Claude Code project instructions to define cost-saving practices and MCP guidance?▼

Yes, CLAUDE.md files support defining cost-saving practices and MCP guidance. By establishing these workflow rules within your project instructions, you shape Claude Code behavior to optimize automation and development sessions.

What is the best way to validate that my CLAUDE.md file improves Claude Code behavior?▼

The best way to validate your CLAUDE.md file is through hands-on creation and testing with a real project. Apply recommended structures and perform verification steps to confirm the project instructions produce the desired Claude Code behavior.

Related Skills

Explore More Software Engineering Skills→
JiaxuanZou0714JiaxuanZou0714
5

teach-impeccable

Gather design context and persist it into a CLAUDE.md file.

Community
Basic
biwakonbubiwakonbu

migration-guide

Migrate CLAUDE.md content into .claude/rules files with references.

Community
Advanced
ouakarouakar

MCP Generator

Generate a project-specific MCP server exposing codebase intelligence as Tools, Resources, and Prompts.

Community
Advanced
fukukei23fukukei23

new-session

Generate structured handoff prompts for Claude Code session transitions.

Community
Advanced