awesome-readmelisted

Write awesome-list-worthy README.md files for GitHub repositories — project READMEs (library, CLI, app, research, template) and GitHub profile READMEs (username/username repo) — with prose that reads as human-written, not AI-generated. Covers section selection, shields.io badge stacks, banner/logo/GIF guidance, TOC patterns, expandable `<details>` blocks, back-to-top anchors, contributor widgets (contrib.rocks, star-history), typing SVGs, GitHub-readme-stats cards, Standard-Readme spec compliance, README-Driven-Development workflow, and a full anti-AI-slop audit pass on every draft (integrates the humanizer skill's Wikipedia "Signs of AI writing" patterns tuned for README prose). Triggers when user asks to generate, write, improve, refactor, humanize, or audit a README; wants badges, TOC, logo placement, demo GIF, feature list, install/usage blocks, contributing section, roadmap, "getting started", or profile README with stats/typing SVG/snake animation. Keywords - readme, README.md, github readme, profile re
fralapo/awesome-agent-skills · ★ 0 · AI & Automation · score 76

Install: claude install-skill fralapo/awesome-agent-skills

# Awesome README Engineering A GitHub README is the front door of a project. The best ones combine a clear value proposition above the fold, scannable structure, credibility signals (badges, contributors, stars), copy-pasteable install/usage, visuals (banner, demo GIF, screenshots), and — most overlooked of all — prose that sounds like a human wrote it. That last point is non-negotiable. A visitor smells AI-generated marketing copy in seconds. Once they do, every other quality signal on the page loses its weight. See [references/voice-and-prose.md](references/voice-and-prose.md) for the full anti-AI-slop protocol; apply it to every draft before writing to disk. This skill produces **two kinds** of READMEs: | Kind | Lives at | Purpose | |---|---|---| | **Project README** | `repo-root/README.md` | Sells and explains a software project to potential users / contributors | | **Profile README** | `username/username/README.md` (special repo) | Personal GitHub landing page — bio, skills, stats, socials | Grammar differs per kind. See [references/profile-readme.md](references/profile-readme.md) for profile specifics. ## When to Use This Skill Trigger on any of: - "Write / generate / create a README for this repo" - "Improve / refactor / audit the README" - "Add badges / TOC / demo GIF / logo / banner" - "Make my GitHub profile README" - "Make my README look like an awesome-readme entry" - "Convert this project description into a README" - User mentions: `shields.io`, `contrib.