OpenParable
Skip to content
← Back to skills

Jira

Productivity
jira

Jira is an Agent Skill for productivity published in the BuilderIO/agent-native repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Search and analyze Jira tickets, sprints, and project analytics. Use this skill when the user asks about tickets, bugs, sprint tracking, or engineering work.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/BuilderIO/agent-native/blob/HEAD/templates/analytics/.builder/skills/jira/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/jira, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Jira Integration

Connection

  • Base URL: $JIRA_BASE_URL (e.g. https://yourorg.atlassian.net)
  • Auth: Basic auth — Base64($JIRA_USER_EMAIL:$JIRA_API_TOKEN)
  • Env vars: JIRA_BASE_URL, JIRA_USER_EMAIL, JIRA_API_TOKEN
  • Caching: 10-minute in-memory cache, max 100 entries
  • API versions: REST API v3 (/rest/api/3), Agile API (/rest/agile/1.0)

Server Lib & API Routes

  • File: server/lib/jira.ts

Exported Functions

FunctionDescription
searchIssues(jql, fields?, maxResults?)Search via JQL
getIssue(issueKey)Get single issue detail
getProjects()List all projects
getStatuses(projectKey?)List statuses (optionally by project)
getBoards()List agile boards
getSprints(boardId)List sprints for a board
getAnalytics(projects, days)Aggregate ticket analytics

API Routes

RouteDescription
GET /api/jira/searchSearch tickets via JQL
GET /api/jira/issueGet issue detail
GET /api/jira/projectsList projects
GET /api/jira/statusesList statuses
GET /api/jira/boardsList boards
GET /api/jira/sprintsList sprints
GET /api/jira/analyticsTicket analytics

Dashboard

  • /adhoc/jira — Jira Tickets dashboard with Overview, Search, and Sprints tabs

Script Usage

# Search tickets
pnpm action jira-search --jql="summary ~ SSO ORDER BY created DESC" --fields=key,summary,status,assignee

# Ticket analytics
pnpm action jira-analytics --days=30
pnpm action jira-analytics --projects=ENG,PROD --days=30

Key Patterns & Gotchas

  • IMPORTANT: The old /rest/api/3/search endpoint was removed by Atlassian (returns 410). Must use /rest/api/3/search/jql instead.
  • JQL for duplicate detection: project = X AND summary ~ "keyword" ORDER BY created DESC
  • Always use markdown links for tickets: [ENG-1234](https://yourorg.atlassian.net/browse/ENG-1234)
  • getStatuses with a projectKey returns an array of issue type entries; the code flattens nested statuses
  • getAnalytics runs multiple search queries and aggregates client-side