Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/setup/marketplace.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ can say so, because it is the floor everything else is managed from.
| `magpie-repo-health` | 7 | ~0.7k |
| `magpie-utilities` | 5 | ~0.5k |
| `magpie-contributor-growth` | 9 | ~0.8k |
| `magpie-mentoring` | 4 | ~0.5k |
| `magpie-mentoring` | 4 | ~0.4k |
| `magpie-pairing` | 2 | ~0.2k |

> [!NOTE]
Expand Down
27 changes: 10 additions & 17 deletions plugins/magpie-mentoring/skills/good-first-issue-author/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,30 +9,23 @@ requires_config:
- issue-tracker-config.md
- project.md
description: |
Draft a single net-new *good first issue* on the configured
`<upstream>` repo from one supplied candidate such as a known gap
or a small maintainer-named task. The skill first runs a
suitability gate to confirm the candidate is small and
newcomer-safe. If it passes the skill drafts one issue. The draft
carries scope, code pointers, contributing-doc links, acceptance
criteria, and an effort estimate. A readiness checklist gates the
draft before it is shown. Nothing is filed via `gh` until the
maintainer explicitly confirms. The skill never curates or
relabels the existing backlog.
Draft one net-new *good first issue* on the configured `<upstream>`
repo from one supplied gap or small maintainer-named task.
Run suitability and readiness checks before showing the draft.
File via `gh` only after explicit maintainer confirmation.
Never curate or relabel the existing backlog.
when_to_use: |
Invoke when a maintainer says "draft a good first issue for NNN",
"turn this gap into a newcomer issue", "write up a good-first-issue
for <small task>", or chains this skill after a backlog-grooming or
planning pass surfaces a small, well-bounded task worth handing to a
first-time contributor. Skip when the task is security-sensitive,
needs an architectural or deprecation decision, is not actually
small, or when an issue for it already exists. Ask before invoking
if the candidate's scope is unclear.
for <small task>", or a grooming or planning pass supplies a small task.
Skip security-sensitive or large tasks, architectural or deprecation
decisions, and tasks with an existing issue.
Ask before invoking if the candidate's scope is unclear.
argument-hint: "[candidate-gap-or-task]"
capability: capability:review
surface_hash: sha256:ac2d0fda09c67231
license: Apache-2.0
measured_tokens: 3609
measured_tokens: 3503
---
<!-- SPDX-License-Identifier: Apache-2.0
https://www.apache.org/licenses/LICENSE-2.0 -->
Expand Down