templates/issues/.agents/skills/issue-management/SKILL.md
CRUD operations for Jira issues. Use when creating, updating, viewing, or searching issues. Covers create-issue, update-issue, get-issue scripts and the issue data model.
npx skillsauth add BuilderIO/agent-native issue-managementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use the create-issue script:
pnpm action create-issue --project PROJ --summary "Fix login bug" --type Bug --priority High
| Arg | Required | Description |
| ------------ | -------- | ---------------------------------------------- |
| --project | Yes | Project key (e.g., PROJ, ENG) |
| --summary | Yes | Issue title/summary |
| --type | No | Issue type: Task, Bug, Story, Epic (default: Task) |
| --priority | No | Priority: Highest, High, Medium, Low, Lowest |
Use the update-issue script:
pnpm action update-issue --key PROJ-123 --summary "Updated title" --priority High --labels "bug,frontend"
| Arg | Description |
| ------------ | ----------------------------------- |
| --key | Issue key (required) |
| --summary | New title |
| --priority | New priority |
| --labels | Comma-separated labels |
Use get-issue for full details:
pnpm action get-issue --key PROJ-123
Returns: summary, status, priority, assignee, reporter, labels, comments, subtasks, linked issues, sprint info.
pnpm action list-issues --view my-issues
pnpm action list-issues --view project --projectKey PROJ
Views: my-issues, project, recent.
# Text search
pnpm action search-issues --q "login bug"
# JQL search (see jql-queries skill)
pnpm action search-issues --jql "issuetype = Bug AND status != Done"
Issues come from the Jira Cloud API. Key fields:
| Field | Type | Description |
| -------------- | ---------- | ------------------------------ |
| key | string | Unique identifier (PROJ-123) |
| summary | string | Issue title |
| status | object | Current status + category |
| priority | object | Priority level |
| issuetype | object | Type (Bug, Task, Story, etc.) |
| assignee | object | Assigned user |
| reporter | object | Creator |
| project | object | Parent project |
| labels | string[] | Labels |
| sprint | object | Current sprint (if assigned) |
| parent | object | Parent issue (for subtasks) |
| subtasks | array | Child issues |
Always run pnpm action refresh-list after creating or updating issues to trigger a UI refresh.
tools
Public booking flow — the state machine, animations, and URL/app-state sync.
tools
Trigger-based automations — reminders, follow-ups, webhooks — across the booking lifecycle.
tools
Team event types, round-robin assignment, collective bookings, host weights, and no-show calibration.
development
The pure `computeAvailableSlots` function — inputs, outputs, invariants, and debugging guide.