Md Context Builder

MD Context Builder

A Claude Code skill that **guides human authoring** of CLAUDE.md files following research-backed best practices.

Quick Start

# Install
cd ~/.claude/skills && git clone https://github.com/goncalovelosa/md-context-builder.git

# Use - just ask Claude:
# "Create a CLAUDE.md for this project"
# "Audit my CLAUDE.md for best practices"

That's it. The skill will analyze your codebase, check for existing docs, and generate a draft for your review.

Research-Backed Approach

This skill incorporates findings from 2026 research:

Source	Key Finding	Application
SkillsBench	Curated Skills: +16.2pp improvement	Focus on procedural knowledge
Evaluating AGENTS.md	LLM-generated: -3%, Human-written: +4%	Guide humans, don't auto-generate
Claude Code memory docs (2026-09)	Claude Code reads CLAUDE.md, never AGENTS.md	One source of truth: AGENTS.md + a CLAUDE.md bridge
Hacker News Discussion	"4% improvement is massive!"	Even small gains matter

**Core insight:** LLM-generated context files hurt performance. This skill generates drafts for human review, not final content.

Features

• Human Review Required - Generates drafts with explicit prompts for tribal knowledge
• Documentation Redundancy Check - Skips content already in README/CONTRIBUTING
• Decision Tree - Helps determine if CLAUDE.md is even needed
• Ultra-Minimal Option - 15-20 line template for well-documented projects
• Cost Warning - Alerts that context files increase agent cost by 20%+
• Progressive Disclosure - Root CLAUDE.md < 60 lines with reference files

Use Cases

1. New Project Setup - Create CLAUDE.md for a codebase without AI context documentation
2. Documentation Audit - Review existing CLAUDE.md against 2026 best practices
3. **Stru