@iceinvein/agent-skills 0.1.23 → 0.1.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iceinvein/agent-skills",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Install agent skills into AI coding tools",
   "author": "iceinvein",
   "license": "MIT",

package/skills/magpie/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dik Rana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/magpie/README.md

@@ -0,0 +1,72 @@
+# magpie
+
+Interactive Claude Code skill that runs a multi-stage PR review pipeline inside the user's Claude Code conversation.
+
+## What it does
+
+Given a GitHub PR number, dispatches five specialist subagents in parallel (security, bugs, performance, code-smells, architecture), dedupes their findings, applies a critic rubric, peer-reviews via `codex exec`, serves an interactive HTML report, and posts the findings the user selects via `gh`.
+
+## Requirements
+
+- `bun` on PATH (https://bun.sh)
+- `gh` on PATH, authenticated (`gh auth status`)
+- `codex` on PATH, authenticated
+- `git` on PATH
+
+## Install
+
+This skill ships in two parts: the prompt (SKILL.md) and a companion Bun CLI (bin + scripts). Both are needed, and `install.sh` handles both in one step.
+
+```
+./install.sh
+```
+
+That symlinks the full skill source tree (bin/, scripts/, templates/, fixtures/, SKILL.md, skill.json) into `~/.claude/skills/magpie/`, then symlinks `bin/magpie` onto your PATH (preferring `/usr/local/bin`, falling back to `~/.local/bin`). Re-run any time to refresh the links.
+
+Once an agent-skills registry entry exists for `magpie`, the prompt half can also be installed via `bunx @iceinvein/agent-skills install magpie`, but the CLI still requires `./install.sh` (or an equivalent manual symlink) because the registry only ships SKILL.md.
+
+## Use
+
+Inside Claude Code, ask: "Review PR 1234" (or paste a PR URL). The agent reads SKILL.md and walks the pipeline; the CLI runs as `magpie setup`, `magpie serve`, etc.
+
+## Development
+
+```
+bun install           # Installs @types/bun
+bun test              # Run all tests
+bun run lint          # Biome check
+bun run typecheck     # tsc --noEmit
+```
+
+### Previewing the UI
+
+Use the bundled example PR fixture to render either page without a real review. Useful for design iteration.
+
+```
+magpie preview                                  # render both pages, open findings.html
+magpie preview --page progress --stage fresh    # progress page at "everything pending"
+magpie preview --page progress --stage specialists-running
+magpie preview --page progress --stage peer-review-error
+magpie preview --no-open --out /tmp/magpie-ui   # write files only
+magpie preview --list-stages                    # see all stage presets
+```
+
+The fixture lives at `fixtures/example-pr/` (pr.json + findings.final.json + post-status.json) and covers all four severities, all five focus domains, every section combination (with/without suggestion code block, with/without verification, raw-prose fallback), and a mix of posted / failed / fresh badges.
+
+## Layout
+
+- `SKILL.md` is the agent-facing prompt; installed by the agent-skills CLI.
+- `skill.json` is the agent-skills manifest.
+- `bin/magpie` is the CLI invoked by the agent during stages; installed by `install.sh`.
+- `scripts/` holds the implementation (server, dedupe, render, setup, cleanup, etc.).
+- `templates/styles.css` is the HTML report stylesheet.
+- `fixtures/` holds canned PR data for tests.
+- `install.sh` symlinks the skill directory into `~/.claude/skills/`.
+
+## Design docs
+
+The original design and implementation plan live at `docs/magpie/design.md` and `docs/magpie/plan.md` at the repo root.
+
+## Run directory layout
+
+Each invocation creates `~/.magpie/pr-<n>-<ts>/` with `pr.json`, `diff.patch`, `findings/`, `findings.deduped.json`, `findings.kept.json`, `findings.final.json`, `screen/`, `state/`, `log.jsonl`. On completion the directory is renamed to `<run-dir>.archived-<timestamp>` rather than deleted, so logs survive for postmortem.