Skip to content
Skills Library
Management & product · Review & audit

skill-intake

/skill-intake

Move incoming issues and pull requests through triage states until each is actionable or closed — use when the queue has piled up or a report arrives unsorted

Author
nyldn ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Move incoming issues and pull requests through triage states until each is actionable or closed — use when the queue has piled up or a report arrives unsorted

Original author description

Move incoming issues and pull requests through triage states until each is actionable or closed — use when the queue has piled up or a report arrives unsorted

How it works

  1. When To Use
  2. When Not To Use
  3. Inputs
  4. Workflow
  5. Provider Or Data Priority
  6. Stop Or Checkpoint Rules
  7. Output Contract
  8. Verification
Original SKILL.md headings · 125 lines, 815 words
SKILL.md preview
---
name: skill-intake
disable-model-invocation: true
description: "Move incoming issues and pull requests through triage states until each is actionable or closed — use when the queue has piled up or a report arrives unsorted"
---

# Intake

Work the incoming queue. Each item moves through a small set of states until it
is either actionable by someone who did not write it, or closed with a reason.

**A pull request is an issue with attached code.** Same states, same moves, with
the deltas noted below. Resolving a bare `#42` means checking both.

Adapted from `triage` in
[mattpocock/skills](https://github.com/mattpocock/skills) (MIT), cut down to the
states this repo can actually represent and retargeted at `gh` and `bd`.

## When To Use

- Open issues or PRs have accumulated and nobody knows which are real.
- A new report arrives and needs sorting before anyone works it.
- An issue has been sitting because it is not clear what it is asking for.
- Before planning, to establish what is actually in the queue.

## When Not To Use

- To do the work an item describes. Triage decides what happens to it, not how.
- For local, private notes. That is `skill-issues` and `.octo/ISSUES.md`.
- To review a PR's code quality. That is `skill-code-review` or
  `skill-staged-review`; intake decides whether the PR should be reviewed at all.

## Inputs

An issue or PR reference, or nothing — with nothing, take the queue in order.
`gh issue list` and `gh pr list` for the public surface; `bd ready` and
`bd blocked` for tracked work.

## Workflow

### 1. Categorise

What kind of thing is it: a bug, an enhancement, a question, or noise. For a PR,
also: does it correspond to an existing issue, or arrive unannounced?

Do not skip this because the title looks obvious. Titles are written by people
who already know what they meant.

### 2. Verify

The step that earns the whole skill. For a bug: **reproduce it, or establish that
you cannot.** For a PR: check the claim it makes is the change it contains.

An unverified bug report is a hypothesis. Filing it as fact wastes whoever picks
it up. If reproduction needs something you do not have — credentials, a dataset,
a platform — that is `needs-info`, not `verified`.

### 3. Assign a state

- **`needs-triage`** — arrived, not yet sorted. The entry state.
- **`needs-info`** — blocked on the reporter. Say exactly what is missing; "more
  detail" is not a request anyone can act on.
- **`verified`** — reproduced or confirmed, ready to be worked.
- **`needs-decision`** — real, but what to do is a judgement call the maintainer
  has not made. Do not resolve these by inference. Escalate, or run
  `skill-pressure-test` with the maintainer.
- **`closed`** — not a bug, out of scope, duplicate, or fixed. Always with a
  reason, and for out-of-scope, why.

### 4. Write the brief

For anything reaching `verified`, write what someone picking it up needs and
would otherwise have to rediscover: where the relevant code is, what you already
ruled out, and how to tell when it is fixed. This is the difference between an
item that gets worked and one that gets re-triaged.

For a PR, add: whether it has tests, whether CI is green, and whether it conflicts
with anything in flight.

### 5. Record it

For public comment text, stream the completed note through the outbound gate:

```bash
printf '%s\n' "$TRIAGE_NOTE" | \
  "${CLAUDE_PLUGIN_ROOT:-${HOME}/.claude-octopus/plugin}/scripts/safe-gh-comment.sh" \
    --repo OWNER/REPO issue-comment ISSUE_NUMBER -
```

Use `gh issue edit --add-label` only for the label mutation. Use `bd update` for
tracked work. If `bd` writes are blocked by pending migrations, say so and do
not run the migration — see `skill-work-slicing` for that constraint.

## Provider Or Data Priority

1. The repository — reproduce against the actual code.
2. CI logs and run history for anything claiming a failure.
3. The reporter, for what only they can supply.
4. Never assume the report is accurate because it is detailed.

## Stop Or Checkpoint Rules

- Stop before closing anything a human filed deliberately, unless it is a clear
  duplicate. Closing is the one move that is rude to get wrong.
- Stop before `needs-decision` items and surface them rather than guessing.
- Do not merge or push as part of triage, even for a PR that looks ready.
- One item at a time. Batch-labelling a queue without reading it is how real
  reports end up buried under a label.

## Output Contract

Per item:

1. **Reference and category.**
2. **State assigned, and why.**
3. **Verification result** — reproduced, could not reproduce, or not attempted
   with the reason.
4. **Brief** — for verified items only.
5. **Action taken** — labels, comments, or the exact commands not run and why.

Then a queue summary: counts by state, and which items are now takeable.

## Verification

- Every `verified` item was actually reproduced, or says explicitly that it was
  not and why.
- Every `needs-info` names the specific missing thing.
- Every closure carries a reason.
- Nothing was merged, pushed, or fixed during triage.

Versions

RepositoryScoreLicence
This page · nyldn/claude-octopus100MIT
joogy06/agent-foundry100MIT

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version bb7cacf0e684 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100ticket-sorting
    Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs. Use when the user types /triage or explicitly asks for this step; do not activate on your own for unrelated requests.
  • 100issue-triage
    Move engineering issues and external PRs through a triage state machine and write agent-ready briefs. Use when clearing a triage queue, deciding if a report is real or wanted, or handing an issue to a coding agent.
  • 90review-triage-queue
    Create a read-only, local triage queue report from OpenShell GitHub intake. Use to review the triage queue, scan incoming issues and community PRs, check main-branch CI failures, or resume a triage pass.
  • 100triage
    Turn incoming reports, external PRs and alerts into evidence-based decisions and agent-ready briefs. Use when: intake arrives. For accepted work, use Plan.
  • 95issue-triage
    Classify incoming issues, external pull requests, or source-thread reports, verify their claims, deduplicate, map labels, and write agent-ready briefs. Includes safe recurring intake setup and owner routing. Use for "triage these issues", "go through the backlog", "is this a…
  • 90issue-triage
    Process incoming issues so real problems get found fast and the queue stays honest about what will be worked on. Use when an issue tracker has grown past what anyone reads.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.