md-craft

Craft beautiful, professional markdown files — READMEs, PR templates, CONTRIBUTING, CHANGELOG, and general project docs — that match the project's existing tone and aesthetic. Use this skill whenever the user wants to write, generate, update, rewrite, polish, or "make better" any markdown file in a repo, even if they don't say "use md-craft." Trigger on phrases like "write a readme", "draft a PR template", "update the changelog", "fix my contributing guide", "my readme sucks", "generate docs for this project", or any request where the deliverable is a .md file that represents or describes a project. Also trigger when the user pastes an existing markdown file and asks to improve, clean up, or modernize it. The skill always gathers project context first (CLAUDE.md, package manifests, docs/, recent git log), always asks the user for style/tone preferences before writing, and always shows a plan/diff before touching any file.