triage-work-item

Investigates tracker work items against codebases and posts verified root-cause analysis comments.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/azborgonovo/ai-skills --skill triage-work-item-azborgonovo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage-work-item
Source: https://github.com/azborgonovo/ai-skills/tree/main/skills/planning/triage-work-item
Command: npx skills add https://github.com/azborgonovo/ai-skills --skill triage-work-item-azborgonovo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Triaging a bug or change request normally means reading a long ticket thread, hunting through repositories, checking logs, and then writing up findings by hand. This Skill automates that end-to-end investigation and posts a verified analysis comment back to the work item, so engineers get an actionable root cause or approach instead of a raw ticket. ## Core Features & Use Cases - End-to-end triage workflow: Fetches the full issue thread and attachments, classifies the item as a bug or change request, investigates the relevant codebases with subagents, corroborates with observability data, and posts a structured analysis comment. - Tracker and observability adapters: Ships with Jira and GitHub Issues adapters plus Grafana and CloudWatch adapters, and degrades gracefully to any reachable platform via tool discovery. - Verification before posting: Re-checks the highest-confidence claims against actual files and line numbers before drafting, and supports a --dry-run mode that writes the comment to a file instead of posting. - Use Case: Given a Jira URL like acme.atlassian.net/browse/PROJ-123 reporting a slow export endpoint, the Skill reads the thread, mines the attached HAR file, traces the controller-to-database call path in the local checkout, confirms the missing pagination, and posts a root-cause comment with fix options. ## Quick Start Ask the AI to triage a work item by saying something like: triage https://github.com/myorg/myrepo/issues/42 and post what you find.

Frequently Asked Questions about triage-work-item

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage a Jira ticket against my codebase automatically?▼

Provide the Jira issue URL or key and ask for a triage. The Skill fetches the full comment thread and attachments, investigates the relevant local repositories with subagents, verifies the findings, and posts a root-cause or approach analysis comment back to the issue.

How do I investigate a GitHub issue and post a root-cause analysis?▼

Pass the GitHub issue URL to the Skill. It uses the gh CLI to read the issue with its full comment thread, scans for inline attachments, investigates the code, and posts a structured Markdown comment with the verified root cause or proposed approach.

Does the triage workflow support trackers other than Jira and GitHub?▼

Yes. When no dedicated adapter exists for the tracker, the Skill degrades gracefully by discovering available tools through ToolSearch or the platform's CLI and API, then proceeds best-effort while noting that tool-specific behavior is unverified.

Can I review the analysis comment before it gets posted?▼

Yes. Pass the --dry-run flag and the Skill writes the finished comment to a file and shows it in the conversation instead of posting. Without the flag, the comment posts automatically once the verification step confirms the findings.

Why does the triage skip log queries for older incidents?▼

Hosted log and trace backends typically retain data for only 14 to 30 days, so a query for an older incident returns empty results. The Skill checks the incident age against the retention window and relies on attachments, which never age out, instead.

When should I not use automated work-item triage?▼

Do not use it to simply read or summarize a work item with no code investigation, or to write new work items. It is designed for diagnosis and root-cause analysis that requires examining codebases and runtime evidence.