Skills for Real Engineers. Straight from my .agents directory.
readme-polish
Agent skill fromalirezarezvani/claude-skills
Use when an existing README must be upgraded, audited, or made scannable: polish/美化/升级/优化/打磨 README, add badges, mermaid, callouts, or collapsible sections, compare against top repos in the same ecosystem, or fix a plain/ugly first screen. Calibrates to the repo's own category, rewrites the hero and information hierarchy, and enforces a deterministic lint gate. Not for brand-new READMEs from scratch or hero-image design.
How to install readme-polish
npx skills add alirezarezvani/claude-skills# or add only this skill to Claude Code: copy the folder
engineering/readme-polish/
# into
~/.claude/skills/readme-polish/ (all projects)
.claude/skills/readme-polish/ (one project)
1# README Polish23Upgrade an **existing** README to the standard of the leading repos in its own ecosystem. Polish is4information hierarchy that survives a 15-second skim; every component must earn its place. This is5not a generator: no banner for a single-tool repo, no badge for a service that does not exist, no6screenshot placeholder.78Do not use it for a README with no content yet, for hero or banner image design, or for API9reference docs. If the README is already accurate and scannable, say so and propose a smaller change.1011## Before starting1213Ask only what the repo cannot tell you: the category (single tool, library or framework, collection,14commercial product), the audience (evaluating developers or installing users), and which claims are15true today (version, license, test status).1617## Modes1819- **Upgrade** (default): run the full workflow and rewrite the file.20- **Audit only**: run steps 1-3 and 5, report findings with line references, do not rewrite.21- **Calibrate**: run step 1 only and recommend a presentation tier with reasons.2223## Workflow24251. **Calibrate.** Sample 2-3 leading repos in the same category and classify them as minimal or26 full-component. Single tools get the middle tier (badges, mermaid, callouts); collections and27 commercial products may use full components. If the network or `gh` is unavailable, take the28 conservative default and write "calibration skipped". Never claim calibration you did not do.29…
Excerpt shown under the repository's MIT license.
More skills in claude-skills
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
New AI tools and agent skills, once a week
The tools added to Tooluck that week, the newest skills for Claude Code, Codex and Cursor, and one side-by-side comparison. No spam, unsubscribe anytime.
