Skip to content

Public-release polish: commercial README, sharper descriptions, repo hygiene#1

Merged
thdurante merged 4 commits into
mainfrom
readme-sell
Jul 7, 2026
Merged

Public-release polish: commercial README, sharper descriptions, repo hygiene#1
thdurante merged 4 commits into
mainfrom
readme-sell

Conversation

@thdurante

@thdurante thdurante commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Polish + hygiene to get reply-pr ready for public / lookmi.

README + description

  • README.md — a calm, matter-of-fact rewrite: states the problem plainly (a PR gathers comments from several reviewers; replying properly is fiddly) and lets the mechanics carry it. Badges, the two mermaid diagrams (flow + reviewer routing), and a plain does/doesn't table. Deliberately not a landing page.
  • SKILL.md — sharpened the description to lead with what it does (what lookmi shows on the card) while keeping the trigger phrases; now says "any bot", not just the big three.

Repo hygiene

  • Removed a skill-creator eval workspace (reply-pr-workspace/) that an earlier git add -A accidentally committed, gitignored *-workspace/, and added a CLAUDE.md rule so it can't recur. That scratch is also on main from an earlier commit — merging this PR removes it from main.

GitHub / lookmi short description

Set to: Triage and reply to a PR's unresolved review comments — reply-only, on each reviewer's channel, with you approving every reply.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation

    • Reworked the skill docs to clarify the reply-only workflow, approval step, and how unresolved PR comments are triaged and resolved.
    • Updated installation and usage examples, including global install guidance and an analysis-only mode.
    • Added repository guidance and a clearer folder layout overview.
  • Chores

    • Updated ignore rules for temporary workspace artifacts.
    • Removed outdated generated logs and evaluation outputs.

- README: reframe around the pain (PRs swarmed by review bots; replying properly
  is fiddly and easy to get wrong) -> how reply-pr solves it. Hero line, badges,
  benefit-first bullets, will/won't table, both mermaid diagrams kept.
- SKILL.md: lead the description with the value (what lookmi shows) while keeping
  the trigger phrases; now says "any bot", not just the big three.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 90f821ed-d0db-4a83-ac9e-5290074e6b35

📥 Commits

Reviewing files that changed from the base of the PR and between a8d79dc and f964cc6.

📒 Files selected for processing (1)
  • README.md
✅ Files skipped from review due to trivial changes (1)
  • README.md

Walkthrough

README.md and skills/reply-pr/SKILL.md are rewritten around reply-only, approval-gated behavior. Repo guidance and ignore rules are added, and reply-pr workspace evaluation JSON content is removed or cleared.

Changes

Documentation and repository housekeeping

Layer / File(s) Summary
README overview and flow
README.md
Rewrites the introduction, purpose, flow description, installation, usage, and reply-routing text.
README reference sections
README.md
Updates the will-and-won't content, requirements formatting, and under-the-hood directory description.
SKILL metadata update
skills/reply-pr/SKILL.md
Replaces the front-matter description with reply-only, approval-gated wording.
Repo guidance and ignore rules
CLAUDE.md, .gitignore
Adds operating guidance for the repo and a scratch-workspace ignore rule.

Workspace evaluation cleanup

Layer / File(s) Summary
Workspace JSON cleanup
reply-pr-workspace/desc-opt/.../*.json, reply-pr-workspace/trigger-eval.json
Removes stored optimization, results, and trigger data from the workspace.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the PR’s public-facing documentation updates and repo hygiene cleanup.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch readme-sell

Comment @coderabbitai help to get the list of available commands.

@thdurante thdurante added the WIP Work in progress — not ready to merge label Jul 7, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 14-17: The README copy overstates the guarantee by claiming “zero
threads unresolved” unconditionally. Update the descriptive text for reply-pr to
say it aims to leave settled threads resolved, while allowing threads to remain
open when waiting on reviewer follow-up or when resolution is premature; keep
the phrasing aligned with the product behavior described in the reply-pr
summary.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 16a4cd41-2f5f-4d02-bb4d-d36e1deb7b1b

📥 Commits

Reviewing files that changed from the base of the PR and between 2d12fe1 and f535223.

📒 Files selected for processing (2)
  • README.md
  • skills/reply-pr/SKILL.md

Comment thread README.md Outdated
An earlier `git add -A` swept skill-creator's `reply-pr-workspace/` eval output
into the repo. Remove it from tracking, gitignore `*-workspace/`, and add a
CLAUDE.md rule (verify staged files; never `git add -A` blindly; don't commit
local scratch/generated artifacts) so it can't recur.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@thdurante thdurante changed the title Sell pass: commercial README + sharper descriptions Public-release polish: commercial README, sharper descriptions, repo hygiene Jul 7, 2026
…t the mechanics carry it

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 66-70: Add a language tag to the fenced command block in README so
markdownlint passes; update the existing docs snippet for the /reply-pr examples
to use a bash fence while keeping the commands unchanged. Locate the Markdown
fence around the /reply-pr usage examples and make the minimal formatting change
only.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a9c6fc60-01bc-4055-a168-a223f07f3ad4

📥 Commits

Reviewing files that changed from the base of the PR and between d2c1850 and a8d79dc.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md Outdated
CodeRabbit flagged the /reply-pr usage fence as missing a language; tag it bash,
and tag the directory-tree block text so the docs are fully lint-clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@thdurante thdurante self-assigned this Jul 7, 2026
@thdurante thdurante removed the WIP Work in progress — not ready to merge label Jul 7, 2026
@thdurante thdurante merged commit 2bd1d6a into main Jul 7, 2026
1 check passed
@thdurante thdurante deleted the readme-sell branch July 7, 2026 12:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant