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
Install this Claude and Codex skill with the command below. The command stays visible even when copy support is unavailable.
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
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.
help-center-ui-test
Used to run a browser-based UI review of the WordPress.com Help Center across multiple surfaces, looking for visual and...