reader-protocol-pr-review
Use when reviewing PRs that touch the Reader's multi-protocol social surfaces (`client/reader/social/`, `client/reader/atmosphere/`, `client/reader/mastodon/`, `packages/api-core/src/reader-{atmosphere,mastodon}/`, `packages/api-queries/src/reader-{atmosphere,mastodon}.ts`). Captures the review rubric + the recurring smells from the CM-625 / CM-658 / CM-660 / CM-662 slice cycle.
Install
With your agent
Install OMGSkills skill "automattic/wp-calypso:reader-protocol-pr-review" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/Automattic/wp-calypso /tmp/wp-calypso && ln -s /tmp/wp-calypso/.claude/skills/reader-protocol-pr-review ~/.claude/skills/reader-protocol-pr-reviewFrom README
Reader Protocol PR Review Use this when reviewing a PR in the Reader's social/atmosphere/mastodon territory — slice work for the protocol-adapter pattern, optimistic mutations, or the shared post-card components. The recurring findings are concrete enough to be a checklist; the rubric below comes from the CM-658/CM-660 cycle where the same issues appeared in both PRs. Rubric For each finding write: Severity tags: blocker (PR can't merge), important (real bug, would cause user-visible issues), nit (cleanup or hardening). File:line: anchor with absolute path or repo-relative path so the comment can be left inline on GitHub. Use gh api repos/Automattic/wp-calypso/pulls/{n}/comments to post inline replies (not top-level PR comments) when the line is in the diff. In-PR vs follow-up: explicitly call this out. Architectural changes that span multiple slices belong in a follow-up issue. Defensive hardening, missing default arms, etc. are cheap to fold in.
More from this repo
calypso-react-query-migration
Used when editing or migrating Calypso Reader data-fetching code — `client/components/data/query-reader-*` components,...
dashboard-create-screen
Used to create a new screen in the Multi-site Dashboard with automatic route registration
fix-e2e-tests
Given a wp-calypso PR number, identify the failing E2E test(s) in that PR's CI run so they can be fixed.