shimo4228

Readme Clarity Reviewer — Development agent for Claude Code

Development community

First-contact reader clarity reviewer for READMEs / repo top pages.

How to install Readme Clarity Reviewer

Installs to ~/.claude/agents/shimo4228-claude-harness-readme-clarity-reviewer.md

Terminal

mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/shimo4228/claude-harness/HEAD/agents/readme-clarity-reviewer.md -o ~/.claude/agents/shimo4228-claude-harness-readme-clarity-reviewer.md

Restart Claude Code, or start a new session, for it to be picked up.

What Readme Clarity Reviewer does

name: readme-clarity-reviewer description: First-contact reader clarity reviewer for READMEs / repo top pages. Reads the README as a visitor who just landed on the repo — knows the general field but nothing of the author's other repos, internal glossary, harness, or editorial process. Flags coined-term overuse, insider-context dependency, Japanese register violations (README ja must be ですます調), lead-density failures, and first-screen comprehension failures. Use PROACTIVELY after drafting or s

Alternatives in Development

Get Commit ID — gh api repos/OWNER/REPO/pulls/PR_NUMBER --jq '.head.sha' gh api repos/OWNER/REPO/pulls/PR_NUMBER/comments \ 1.3k ★
Documentor — Technical documentation, API docs, READMEs 801 ★
Parts Contributor — Use when adding or modifying a part in the Cosmos parts library — a new switch, microcontroller, display, trac 662 ★