From 0914a8c11e9d801a2bbc882e3a7fecf7691778ee Mon Sep 17 00:00:00 2001 From: Dean Stratakos <29683763+dastratakos@users.noreply.github.com> Date: Mon, 4 May 2026 22:53:31 -0700 Subject: [PATCH 1/2] chore: mark internal skills as non-installable and update README Add `metadata.internal: true` to all .agents/skills/ SKILL.md files so that `npx skills add ReviewStage/stage-cli` only exposes the public stage-chapters skill. Update README to better describe the product. --- .agents/skills/deslop-ui/SKILL.md | 2 ++ .agents/skills/fixing-ci/SKILL.md | 2 ++ .agents/skills/fixing-pr-comments/SKILL.md | 2 ++ .agents/skills/iterate-pr/SKILL.md | 2 ++ .agents/skills/linear-issue/SKILL.md | 2 ++ .agents/skills/quality-review/SKILL.md | 2 ++ .agents/skills/rebase-origin-main/SKILL.md | 2 ++ .agents/skills/trade-off/SKILL.md | 2 ++ README.md | 19 ++++--------------- 9 files changed, 20 insertions(+), 15 deletions(-) diff --git a/.agents/skills/deslop-ui/SKILL.md b/.agents/skills/deslop-ui/SKILL.md index 6cf9e38..dff68c0 100644 --- a/.agents/skills/deslop-ui/SKILL.md +++ b/.agents/skills/deslop-ui/SKILL.md @@ -1,6 +1,8 @@ --- name: deslop-ui description: Use when building or reviewing UI components, pages, or layouts to ensure premium, intentional design that never looks vibe coded +metadata: + internal: true --- You are a senior product designer and front end engineer who specialises in clean, premium, intentional UI. Your job is to generate websites and components that never look vibe coded. Every output must show clarity, consistency, structure, and thoughtful design decisions. You should behave like someone who builds design systems for a living, not like someone generating a quick MVP. diff --git a/.agents/skills/fixing-ci/SKILL.md b/.agents/skills/fixing-ci/SKILL.md index 3c3e9f2..a24e08e 100644 --- a/.agents/skills/fixing-ci/SKILL.md +++ b/.agents/skills/fixing-ci/SKILL.md @@ -1,6 +1,8 @@ --- name: fixing-ci description: Use when CI is failing on a branch and you need to diagnose failures from GitHub, fix them locally with iterative verification, and re-push clean commits. +metadata: + internal: true --- # Fixing CI diff --git a/.agents/skills/fixing-pr-comments/SKILL.md b/.agents/skills/fixing-pr-comments/SKILL.md index b70f79d..c1f37f4 100644 --- a/.agents/skills/fixing-pr-comments/SKILL.md +++ b/.agents/skills/fixing-pr-comments/SKILL.md @@ -1,6 +1,8 @@ --- name: fixing-pr-comments description: Use when a pull request has unresolved review comments that need to be addressed, or when asked to fix PR feedback +metadata: + internal: true --- # Fixing PR Comments diff --git a/.agents/skills/iterate-pr/SKILL.md b/.agents/skills/iterate-pr/SKILL.md index 0dfb0b9..e6f59cd 100644 --- a/.agents/skills/iterate-pr/SKILL.md +++ b/.agents/skills/iterate-pr/SKILL.md @@ -1,6 +1,8 @@ --- name: iterate-pr description: Use when a PR is open and the user wants to autonomously monitor and fix PR review comments, CI failures, and rebase conflicts on a recurring loop, or when asked to babysit/iterate on a PR +metadata: + internal: true --- # Iterate PR diff --git a/.agents/skills/linear-issue/SKILL.md b/.agents/skills/linear-issue/SKILL.md index 076f7f1..48a3196 100644 --- a/.agents/skills/linear-issue/SKILL.md +++ b/.agents/skills/linear-issue/SKILL.md @@ -1,6 +1,8 @@ --- name: linear-issue description: Use when creating a Linear issue from the current coding context, or when the user invokes /linear-issue. Infers team, priority, status, and relationships from conversation context, working directory, and git branch. +metadata: + internal: true --- # Creating Linear Issues diff --git a/.agents/skills/quality-review/SKILL.md b/.agents/skills/quality-review/SKILL.md index 7a95974..31a270a 100644 --- a/.agents/skills/quality-review/SKILL.md +++ b/.agents/skills/quality-review/SKILL.md @@ -1,6 +1,8 @@ --- name: quality-review description: Use when reviewing code changes against AGENTS.md implementation quality standards, or when asked to do an implementation quality review +metadata: + internal: true --- # Quality Review diff --git a/.agents/skills/rebase-origin-main/SKILL.md b/.agents/skills/rebase-origin-main/SKILL.md index 89a771e..648d983 100644 --- a/.agents/skills/rebase-origin-main/SKILL.md +++ b/.agents/skills/rebase-origin-main/SKILL.md @@ -1,6 +1,8 @@ --- name: rebase-origin-main description: Use when rebasing the current branch onto origin/main, including resolving merge conflicts along the way +metadata: + internal: true --- # Rebase with origin/main diff --git a/.agents/skills/trade-off/SKILL.md b/.agents/skills/trade-off/SKILL.md index a5c728b..82d0285 100644 --- a/.agents/skills/trade-off/SKILL.md +++ b/.agents/skills/trade-off/SKILL.md @@ -1,6 +1,8 @@ --- name: trade-off description: Use at any stage — planning, before implementing, or reviewing code that's already written — to surface high-level trade-offs that could significantly simplify the work. Scans two layers in strict priority order. First, user-facing behavior (features, flows, states, settings, notifications, undo, real-time, bulk ops) — cutting a behavior removes the architecture and code behind it. Second, architectural design (queues, caches, background jobs, new packages, new tables, new services, streaming, real-time infra) — cutting an architectural piece removes whole categories of implementation. Stops there; code-level simplification is outside scope. Proactively invoke whenever the scope of a task looks like it could grow, whenever you catch yourself about to add a queue, cache, new package, new table, new service, or behavior that wasn't explicitly requested, or when looking back at a recent diff that feels larger than the task warranted. +metadata: + internal: true --- # Trade-off diff --git a/README.md b/README.md index a080a58..9735686 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # stagereview -Chapter-style code review against your local git branch. Run it from your AI coding agent — no server, no telemetry, no API key. +AI-powered code review tool that organizes pull requests into logical chapters and surfaces risks before you dive into the code. Run it from your local AI coding agent of choice. + +Try the full Stage experience with GitHub integration at [https://stagereview.app](https://stagereview.app). ## Install @@ -24,13 +26,7 @@ In your AI agent, run: /stage-chapters ``` -This breaks your branch's diff into reviewable "chapters". - -To open a generated chapters file directly: - -```bash -stagereview show path/to/chapters.json -``` +This breaks your branch's diff into reviewable "chapters" and opens a local browser window to view the chapters. ## What it does @@ -38,13 +34,6 @@ stagereview show path/to/chapters.json - Opens a local browser to view the chapters - Runs entirely on your machine -## What it does NOT do - -- Connect to any Stage server -- Send telemetry or analytics -- Require an API key or login -- Upload your code anywhere - ## License MIT From 58040dbbb683651eb06d0b54b91e781ff3ef1f1d Mon Sep 17 00:00:00 2001 From: Dean Stratakos <29683763+dastratakos@users.noreply.github.com> Date: Mon, 4 May 2026 22:57:55 -0700 Subject: [PATCH 2/2] chore: tweak README tagline --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9735686..e60add9 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # stagereview -AI-powered code review tool that organizes pull requests into logical chapters and surfaces risks before you dive into the code. Run it from your local AI coding agent of choice. +AI-powered code review tool that organizes pull requests into logical chapters and surfaces risks before you dive into the code. Run it from your local coding agent of choice. Try the full Stage experience with GitHub integration at [https://stagereview.app](https://stagereview.app).