diff --git a/.agents/skills/magpie-good-first-issue-sweep b/.agents/skills/magpie-good-first-issue-sweep new file mode 120000 index 00000000..39333654 --- /dev/null +++ b/.agents/skills/magpie-good-first-issue-sweep @@ -0,0 +1 @@ +../../skills/good-first-issue-sweep \ No newline at end of file diff --git a/.claude/skills/magpie-good-first-issue-sweep b/.claude/skills/magpie-good-first-issue-sweep new file mode 120000 index 00000000..916fb3e7 --- /dev/null +++ b/.claude/skills/magpie-good-first-issue-sweep @@ -0,0 +1 @@ +../../.agents/skills/magpie-good-first-issue-sweep \ No newline at end of file diff --git a/.github/skills/magpie-good-first-issue-sweep b/.github/skills/magpie-good-first-issue-sweep new file mode 120000 index 00000000..916fb3e7 --- /dev/null +++ b/.github/skills/magpie-good-first-issue-sweep @@ -0,0 +1 @@ +../../.agents/skills/magpie-good-first-issue-sweep \ No newline at end of file diff --git a/docs/labels-and-capabilities.md b/docs/labels-and-capabilities.md index 296467a3..4b81cd30 100644 --- a/docs/labels-and-capabilities.md +++ b/docs/labels-and-capabilities.md @@ -147,6 +147,7 @@ Capabilities for every skill currently in | `pairing-multi-agent-review` | `capability:review` | | `pr-management-mentor` | `capability:review` | | `good-first-issue-author` | `capability:review` *(authors a newcomer-ready good first issue — contributor mentoring on the supply side)* | +| `good-first-issue-sweep` | `capability:review` *(sweeps the open issue backlog for GFI candidates; scores each against the G1–G7 rubric and proposes the label on maintainer confirmation)* | | `mentoring-welcome` | `capability:review` *(drafts a first-contact orientation comment for first-time contributors on issues and PRs)* | | `issue-fix-workflow` | `capability:fix` | | `audit-finding-fix` | `capability:fix` | diff --git a/skills/good-first-issue-sweep/SKILL.md b/skills/good-first-issue-sweep/SKILL.md new file mode 100644 index 00000000..08e30a3d --- /dev/null +++ b/skills/good-first-issue-sweep/SKILL.md @@ -0,0 +1,307 @@ +--- +name: magpie-good-first-issue-sweep +mode: Mentoring +description: | + Sweep the open `` backlog for existing issues that + could be labelled as good first issues. Score each candidate against + the G1–G7 suitability rubric (scope, self-containment, code pointer, + small effort, no security sensitivity, no architectural decision, no + deprecation decision) and classify it as READY (propose the GFI + label), NEAR-MISS (surface specific edits to make it GFI-ready), or + SKIP (not suitable). Applies labels only after explicit maintainer + confirmation; never edits issue bodies without the maintainer's + direction. +when_to_use: | + Invoke when a maintainer says "find good first issues in the backlog", + "which open issues could a newcomer pick up", "label existing issues + as good first issue", or "curate the backlog for newcomers". Also + useful before a mentoring push or contributor-growth sprint when the + team wants to stock the on-ramp queue from existing work. Skip when + the goal is to draft a brand-new issue from a known gap — use + `good-first-issue-author` for that. Ask before running if + `/good-first-issue-config.md` is absent. +argument-hint: "[--component