Better Readme
Use when the user asks to create, improve, fix, or audit a README.md file, score their README, document an open source project, or set up new project docs. Provides 8-dimension 0-100 quality scoring, 5-type template matrix (Library, CLI, App, Skill, Data), and pre-publish checklist. Do NOT use for API docs, wikis, inline code comments, or general technical writing.
Install
npx skills add Thomaszhou22/better-readme --skill better-readmegit clone --depth 1 https://github.com/Thomaszhou22/better-readme.git /tmp/better-readme
mkdir -p ~/.claude/skills
cp -r /tmp/better-readme/. ~/.claude/skills/better-readmePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Better README Create, audit, and optimize project README files with **8-dimension quality scoring (0–100)**, 5-type template matching (Library, CLI, App, Skill, Data), and pre-publish readiness checks. **Key differentiator:** The 0–100 audit score evaluates READMEs across 8 dimensions — first impression, problem statement, quick start, visual demo, feature clarity, API docs, badges, and community. Nothing else on ClawHub does this. ## Activation Triggers - "write/improve/fix my README" - "create a README for this project" - "score/check my README" - "my README is bad" - "I need a README template" - "document my open source project" - Setting up a new open-source project - Preparing a GitHub launch ## Workflow ### Phase 0: Onboarding (first use only) When this skill is activated for the first time (no prior onboarding record): 1. Briefly introduce what this skill can do (score, improve, create READMEs) 2. Ask the user: _"Want me to evaluate the READMEs of your existing repos?"_ 3. If yes: - Fetch the user's public GitHub repo list - Let the user pick which repos to evaluate (or evaluate all) - Run Phase 2 (Score) on each selected repo's README - Summarize scores and highlight the weakest ones - Offer to improve the lowest-scoring READMEs 4. If no, skip ahead to the normal workflow 5. Record that onboarding is complete (do not repeat) ### Phase 1: Classify Identify the project type by scanning the codebase: | Signal | Project Type |
Details
- Skill name
better-readme- Repository
- Thomaszhou22/better-readme
- Repo updated
- 16 June 2026
FAQ
What does the Better Readme skill do?
Use when the user asks to create, improve, fix, or audit a README.md file, score their README, document an open source project, or set up new project docs. Provides 8-dimension 0-100 quality scoring, 5-type template matrix (Library, CLI, App, Skill, Data), and pre-publish checklist. Do NOT use for API docs, wikis, inline code comments, or general technical writing.
How do I install the Better Readme skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add Thomaszhou22/better-readme --skill better-readme. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Better Readme popular?
It lives in Thomaszhou22/better-readme, which has 9 GitHub stars and 0 forks.
Related skills
Dan Koe Validator
9antoinersx/dan-koe-validator
Validates and edits articles to match Dan Koe's writing style. Use when reviewing content for Koe-style voice, structure, or philosophy alignment. Triggers on requests to "validate article," "edit in Dan Koe style," "check if this sounds like Koe," "review my newsletter," or any content review against the Koe framework.
Typst
8akilrammohan/typst-skill
Write and create Typst documents (.typ files). Use when the user asks to create, write, edit, or convert documents to Typst format, write Typst markup, create academic papers, reports, or documents in Typst, convert LaTeX to Typst, or work with .typ files. Typst is a modern markup-based typesetting system alternative to LaTeX.
Deutsch Loop
9ahmtsahin/deutsch-loop
Coach German writing and conversation with minimal corrections, persistent root-cause mistake tracking (FehlerDNA), mistake-based spaced repetition with a new sentence every time, roleplay whose words return in spaced reviews, continuing preparation for real-life goals across sessions, and an honest progress profile. Use for German correction, personalized review, vocabulary, progress, roleplay, or preparation for an interview, presentation, appointment, or other concrete event; do not use for translation-only requests without learning or feedback.
Spec Forge
10tercel/spec-forge
Professional specification system for Codex. Use when the user asks to create, improve, review, audit, analyze, or propagate product/software documentation, including requirements documents to hand to an implementation team or vendor, SRS/functional/non-functional requirements, PRDs and business cases, ideas, technical designs, architecture/RFC docs, feature specs, test cases, documentation audits, document landscape analysis, and full idea-to-spec chains. The chain's spine is a delivery-grade requirements spec followed by a technical design, handed off to code-forge for implementation: [idea]
Forge
9JYSimilar/Forge
Use when a user wants help turning a vague idea, messy workspace, existing project, small tool, MVP, docs task, AI-assisted task, review, handoff, or release into a real usable result with AI agents. Forge is a project-manager skill for ordinary people: clarify ideas, scope MVPs, plan work, create bounded current-agent tasks, verify results, write docs, and prepare handoff or release. Safe Work Order is the default execution unit for AI tasks, not the whole product.
Human Writing
10w93139/human-writing
通用中文创作与改稿 Skill。用于知乎回答、论坛长帖、公众号文章、博客、评论、人物故事、历史叙事、新闻与行业解读、产品分析、科普、教程、评测、个人叙事、小说、故事、对白、口播和演讲稿。用户没有选题、材料或明确主旨时,先主动提供思考入口,与用户多轮澄清并共同确定主旨,再研究材料、确定选题和框架,不急着交稿。已有明确任务时,默认写成一个见过事、查过材料、愿意把来龙去脉讲清楚的人在说话,重点保留中文互联网长回答与长帖的活人感和自然中文韵律,避免空泛的机构腔、喊口号式演说腔、营销腔和模型腔。非虚构长文先检查材料够不够,材料不足时研究、追问或缩短,绝不用重复解释灌字数。现实内容额外核验事实、引语、数据与用户亲历;产品与行业观点稿在成稿前还会绑定关键论点与证据,并用最强反方压力测试暂定主旨。虚构内容可以创造人物、场景、对白、心理与情节。成稿正文严禁冒号、破折号、“不是……而是……”及同类翻案句,并清除商业黑话和模型惯用黑话。用户明确开启持续风格迭代时,可以在独立作者档案中记录经其确认的长期偏好;不根据一次换词或聊天口气静默学习,不自动修改本 Skill。
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.