---
name: skill-issue-capture
type: skill
description: Inline-callable procedure that files a Backlog ticket in Apps / os.Claude when a skill hits an unexpected problem. Invoke directly from a failure path — not a scheduled skill. Use whenever a skill encounters an error or gap that needs Aled's attention and is not already captured by the current ticket's Blocked state.
license: CC BY-NC-SA 4.0
---

# skill-issue-capture

A shared inline procedure for filing problem-capture tickets. Called from a skill's failure path at the moment a problem occurs — not at end-of-run (end-of-run friction belongs to `skill-ops-retro`). Follows `convention-linear`.

## When to call

Call this from any skill's failure path when the problem is:

- **Not already the current ticket's Blocked state.** If the exec leg gets Blocked on a ticket, that ticket IS the record. Call skill-issue-capture for problems that are separate from the work ticket: infrastructure failures, tool errors, ops-layer gaps, or (for skill-ops-sync) artefacts missing from the repo.
- **Worth tracking.** A one-off transient error does not need a ticket. File when the problem would recur or needs a human decision to fix.

## Behaviour

Given a problem description:

1. **Check for an existing ticket — by title, then by comment.** Search os.Claude Backlog for a ticket with a matching title or problem description (OPS: / FIX: / DRIFT: prefix). If an exact match exists, add a comment noting the recurrence with today's date instead of opening a new ticket.

   **Then read the one or two open tickets most likely to be tracking the *system* the finding is about** — an in-flight migration or config ticket, an open EPIC — and read their recent comments, not only their titles. A fast-moving diagnosis is recorded as a comment on the umbrella ticket first, precisely because that is quicker than authoring a new one, and a title-scoped search cannot reach it: the umbrella's title names the migration, not the regression sitting inside its thread. This binds hardest where the finding concerns a component under active, recent change — a migration, a rollout, a config sweep. Keep it to the one or two most plausible umbrella tickets rather than a general comment search, so the check stays cheap. (Worked case: the 2026-09-08 `task-health` run found `task-daily-report` enabled, with zero recorded runs since its 2026-09-04 cloud migration and zero status updates in the trailing seven days — a confirmed first-class regression by the letter of the registry. Several title-scoped searches for `task-daily-report` returned nothing. The full diagnosis — 29 of 33 tasks disabled, root-caused to a migration that created the tasks and never switched them on — was already a comment posted that morning on APP-1100, a migration-tracking ticket whose title gives no hint it holds a live regression. The duplicate was avoided only by a broader sweep than this procedure required — APP-1175.)
2. **File a Backlog ticket** in Apps / os.Claude with the standard shape (per `convention-linear`):
   - **Title** — prefix: `FIX:` (defect), `OPS:` (operational gap), or `DRIFT:` (canon vs reality). Specific, not generic.
   - **Objective** — one sentence: what happened and in which skill.
   - **Why this matters** — impact if left unfixed; note if recurring.
   - **Proposed change** — the specific edit and exactly which skill/file/section it touches. Embed acceptance criteria (Pattern A) where the fix is a coded change with a clear scope.
   - **Notes for Aled** — any open questions or decisions needed.
   - **On completion** — "Refine with the answers above, then move to Todo."
   - Labels: `type:task` (or `type:bug`) + `work:configuration`. Executor (the `agent`-group single-select): `agent:F0-RGE` for a clean coded change with Pattern A criteria embedded; the `human` value otherwise. **Project: always set** — inherit it from the ticket or run the capture arose from, or `os.Claude` for a canon-side capture; a projectless capture is swept by nobody (`convention-ticket`, *Filing invariant*; APP-984).
   - State: Backlog. Assign Aled.

## Guardrails

- **Runtime/repo problems only — not canon friction.** This captures defects, tool errors, ops gaps and missing-from-repo artefacts (`FIX:`/`OPS:`/`DRIFT:`) that route to Forge or the operator as delivery work. An ops-layer canon improvement — a wording, structure or convention tweak to how Claude is operated — is *not* this skill's remit: it goes to the **Pulse friction queue** via `skill-ops-retro` capture mode (`FRICTION:` prefix, `agent:PUL-5E`), to be drained into a save-ready artefact, never executed by Forge. Keep the lanes apart: repo changes go through Forge; canon changes go through the save button.
- Files to Backlog only. Never moves, closes, or resolves anything.
- Duplicate captures are tolerated. `skill-triage` detects duplicates on its sweep and moves the redundant one to Duplicate state.
- Never edits a SKILL.md or any canon inline. The output is a ticket, not a fix.
