ziw-triage
Use for issue tracker triage of a project's selected ticket or queue, preparing single-PR tickets from repository evidence and routing decomposition or human decisions.
How do I install this agent skill?
npx skills add https://github.com/zaks-io/skills --skill ziw-triageIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is safe for use. It implements a structured issue triage workflow that utilizes local automation scripts and issue tracker tools. The skill includes robust safety instructions, specifically directing the agent to treat data from external sources as untrusted evidence to prevent prompt injection attacks.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Triage
Prepare unclaimed tickets for Orchestrate and name the next owner for unresolved work. Terms and labels follow the workflow contract.
Inputs
The repo config and a selected ticket or queue scope. Queue scope defaults to
intake and ready states; include Backlog only when requested. Orchestrate's
prepare-ticket action selects exactly one ticket. Never expand that selection.
Steps
-
Fetch a selected ticket directly. For a queue, run the scoped snapshot:
node <skill-dir>/../ziw-orchestrate/scripts/tick-snapshot.mjs \ --config docs/agents/workflow/planner.json \ --linear-states <scope states> > /tmp/triage-snapshot.jsonIf collection fails or skips the tracker, read the scope once with tracker tools. Leave active tickets, tickets with PRs, duplicates, and tickets outside scope unchanged. Orchestrate owns active work.
-
For a ticket with a clear outcome and acceptance criteria, inspect bounded, relevant repository code, tests, config, and existing commands to fill technical gaps such as Checks and Likely files, as the contract allows without spec approval. Derive details from evidence; never invent scope, acceptance criteria, or paths.
-
Give each prepared ticket one outcome:
ready: its body and labels are complete. Move it to the ready state withready-for-agent, even when blocked.needs-slicing: it genuinely needs multiple PRs and has a spec markedStatus: Ready for slicing. Route to To Issues with the split reason andneeds-info.needs-human: product scope or another required decision remains unclear, including approval of a missing decomposition spec. Addready-for-humanand the exact question; never invent a spec.
For either unresolved outcome, remove
ready-for-agentand return the ticket to intake. Include the exact missing evidence when technical preparation cannot finish. -
Combine body and evidenced metadata fixes into one update per ticket. Read the ticket back after updating to confirm its final
updatedAt. -
For a queue, refresh its snapshot and run
<skill-dir>/../ziw-orchestrate/scripts/linear-dag-start.mjson it, or on the refreshed tracker JSON array. Report cycles and blockers with an owner.
Rules
- Change only tickets in the requested scope.
- Don't close, cancel, reprioritize, or rewrite scope unless asked.
- If the tracker rate-limits you, stop all tracker calls and report the changes still pending.
Done
Return each prepared ticket's identifier, outcome as ready, needs-slicing,
or needs-human, reason, and confirmed post-update updatedAt. Include changes,
exact questions, and next owners. Report skipped tickets separately without a
preparation outcome. Never report an unconfirmed revision as completed preparation.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/zaks-io/skills/ziw-triage">View ziw-triage on skillZs</a>