Claude Md Authoring
Creates and reviews CLAUDE.md configuration files for Claude Code. Applies HumanLayer guidelines including instruction budgets (~50 user-level, ~100 project-level), WHAT/WHY/HOW framework, and progressive disclosure. Identifies anti-patterns like using Claude as a linter for style rules.
Install
npx skills add ratacat/claude-skills --skill claude-md-authoringgit clone --depth 1 https://github.com/ratacat/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/skills/claude-md-authoring ~/.claude/skills/claude-md-authoringPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# CLAUDE.md Authoring ## Quickstart 1. **Determine scope**: User-level (`~/.claude/`) or project-level (`.claude/`)? 2. **Apply WHAT/WHY/HOW framework** (project-level only) 3. **Keep instructions under budget**: ~50 for user-level, ~100 for project-level 4. **Never use Claude as a linter**: Style rules belong in tooling, not CLAUDE.md 5. **Validate with quality checklist** before finalizing ## Core Principle > "The only thing that the model knows about your codebase is the tokens you put into it." CLAUDE.md is the highest-leverage point for context transfer. Every instruction competes for limited attention. Include only what Claude cannot infer and must apply universally. ## Scope Decision ### User-Level (`~/.claude/CLAUDE.md`) Applies to ALL projects. Include only: - Personal working style preferences - Relationship dynamics (pushback, honesty, communication) - Universal philosophy (YAGNI, root-cause debugging) - Proactiveness boundaries Never include: - Project-specific commands (build, test, lint) - Tech stack details - Style rules that vary by project - Tool/framework references that don't exist everywhere ### Project-Level (`.claude/CLAUDE.md`) Applies to ONE project. Use the WHAT/WHY/HOW framework: **WHAT** (2-5 lines) - Project purpose in one sentence - Primary language/framework - Key directories and their purposes **WHY** (optional, 2-3 lines) - Non-obvious architectural decisions - Constraints that affect implementation choices **HOW** (3-7 lines)
Details
- Skill name
claude-md-authoring- Repository
- ratacat/claude-skills
- Path
skills/claude-md-authoring/SKILL.md- Repo updated
- 11 February 2026
FAQ
What does the Claude Md Authoring skill do?
Creates and reviews CLAUDE.md configuration files for Claude Code. Applies HumanLayer guidelines including instruction budgets (~50 user-level, ~100 project-level), WHAT/WHY/HOW framework, and progressive disclosure. Identifies anti-patterns like using Claude as a linter for style rules.
How do I install the Claude Md Authoring skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add ratacat/claude-skills --skill claude-md-authoring. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Claude Md Authoring popular?
It lives in ratacat/claude-skills, which has 59 GitHub stars and 10 forks.
Related skills
Skill Creator
59ratacat/claude-skills
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
Skill Installer
59ratacat/claude-skills
Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).
Agent Browser
59ratacat/claude-skills
Browser automation using Vercel's agent-browser CLI. Use when you need to interact with web pages, fill forms, take screenshots, or scrape data. Alternative to Playwright MCP - uses Bash commands with ref-based element selection. Triggers on "browse website", "fill form", "click button", "take screenshot", "scrape page", "web automation".
Create Agent Skill
59ratacat/claude-skills
Create or edit Claude Code skills with expert guidance on structure and best practices
Bug Reproduction Validator
59ratacat/claude-skills
Use this agent when you receive a bug report or issue description and need to verify whether the reported behavior is actually a bug. This agent will attempt to reproduce the issue systematically, validate the steps to reproduce, and confirm whether the behavior deviates from expected functionality. <example>\ Context: The user has reported a potential bug in the application.\ user: "Users are reporting that the email processing fails when there are special characters in the subject line"\ assistant: "I'll use the bug-reproduction-validator agent to verify if this is an actual bug by attemptin
Creating Agent Skills
59ratacat/claude-skills
Expert guidance for creating, writing, and refining Claude Code Skills. Use when working with SKILL.md files, authoring new skills, improving existing skills, or understanding skill structure and best practices.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.