Skip to content

Add skill support to the installer, plus the pick-pr-review skill - #3

Open
gregjkal wants to merge 2 commits into
masterfrom
add-skill-support
Open

Add skill support to the installer, plus the pick-pr-review skill#3
gregjkal wants to merge 2 commits into
masterfrom
add-skill-support

Conversation

@gregjkal

@gregjkal gregjkal commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Makes the installer able to ship directory-based tools, not just single prompt files, and adds the first one.

  • Skills as a second install class. A command is one .md in ~/.claude/commands. A skill is a directory: SKILL.md plus the scripts it calls. Register one by adding its directory to the new SKILLS array.
  • Installs for Claude Code and Cursor, which read the same SKILL.md format, so one directory serves both. Destinations override with SKILL_DEST=a:b.
  • First skill, /pick-pr-review. Scans open PRs across wg21-website and wg21-paperflow and names the single one worth reviewing next, ranked by who is waiting on whom. It offers to run the review rather than starting one, and posts findings as a pending draft for the human to submit.
  • Two commits: installer first, then the skill.

Tested on bash 3.2, the macOS system bash that curl | bash actually uses: fresh install, re-install, uninstall, single-destination override, and the real tarball download path.

One call for you: no paired image. AGENTS.md says to stop and ask when one is missing, so I am asking. I left it out because SKILL.md is agent-facing, loaded into the model's context rather than read by a person, so an <img> tag is dead weight and the PNG ships to every install. Say the word and I will add one, either at tools-wg21/images/ for the README or inside the skill directory.

Follow-up in #4, stacked on this: the tools-wg21 reorg had left the installer silently shipping 21 commands instead of 35, and the README WG21 links dead. Skills were unaffected.

A command is a single prompt file copied to ~/.claude/commands. A skill is a
directory: a SKILL.md plus whatever scripts it calls. The whole directory has to
travel together, which is why skills need their own list and their own path.

Skills install to ~/.claude/skills and ~/.cursor/skills, since Claude Code and
Cursor read the same SKILL.md format and one directory serves both. Override
with SKILL_DEST, or point it at a single path to install for one agent only.

Register a skill by adding its directory to the SKILLS array. Entries resolve
from the repo root rather than tools/, since skills live outside it. The array
is empty here; the first skill follows.

Re-install clears the previous copy before writing, so a file dropped upstream
does not linger. Uninstall removes a directory only if it still contains a
SKILL.md.
Scans the open PRs across wg21-website and wg21-paperflow and recommends the
single one worth reviewing next, to remove the friction of choosing.

Ranks by who is waiting on whom: PRs you reviewed where the author has since
replied or pushed, then PRs where your review was requested, then unreviewed
ones. Your own PRs, PRs you approved with nothing changed since, and drafts you
have no involvement with are dropped. Ties break on how close the PR sits to
areas you have committed to in the last 90 days, then oldest wait first.

The skill offers to run the review rather than starting one, and posts findings
as a pending draft review for the human to submit.
@gregjkal
gregjkal force-pushed the add-skill-support branch from ee438f0 to 17843a9 Compare August 5, 2026 17:01
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