authoring-claude-md

Installation
SKILL.md

CLAUDE.md and Rules Authoring

Create effective CLAUDE.md files and .claude/rules/ rule files that serve as project-specific memory for AI coding agents.

Purpose

CLAUDE.md files and rule files provide AI agents with:

  • Non-obvious conventions, architectural patterns and gotchas
  • Confirmed solutions to recurring issues
  • Project-specific context not found in standard documentation
  • Path-scoped instructions that only load when relevant files are touched

Not for: Obvious patterns, duplicating documentation, or generic coding advice.

Core Principles

Signal over noise: Every sentence must add non-obvious value. If an AI agent could infer it from reading the codebase, omit it.

Actionable context: Focus on "what to do" and "why it matters", not descriptions of what exists.

Related skills
Installs
62
GitHub Stars
131
First Seen
Feb 7, 2026