jira — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited jira (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
This skill provides comprehensive Jira project management capabilities through the Atlassian MCP integration. It enables agents to create, update, search, comment on, and link issues programmatically. Use this skill whenever a task involves managing work items in Jira — whether creating new tickets, updating existing ones, querying backlogs, or orchestrating cross-issue relationships.
Epic
└── Story / Task / Bug
└── Sub-task| Type | Purpose | When to Use |
|---|---|---|
| Epic | Large body of work spanning multiple sprints | Feature areas, initiatives, major deliverables |
| Story | User-facing functionality | "As a user, I want..." — delivers value to end users |
| Task | Technical work not directly user-facing | Infrastructure, refactoring, tooling, research spikes |
| Sub-task | Granular unit of work under a Story/Task | Backend endpoint, frontend component, test suite, migration |
| Bug | Defect in existing functionality | Something that worked before and is now broken, or doesn't match spec |
| Field | Description | Notes |
|---|---|---|
project | Project key (e.g., PROJ) | Must exist in the Jira instance |
summary | One-line title | Imperative mood, <80 characters |
issuetype | Epic, Story, Task, Sub-task, Bug | Must match project's configured types |
| Field | Description | Example Values |
|---|---|---|
description | Detailed body (ADF or markdown) | See templates below |
priority | Urgency level | Highest, High, Medium, Low, Lowest |
labels | Categorical tags (array) | ["backend", "api", "tech-debt"] |
components | Architectural components (array) | ["auth-service", "web-app"] |
assignee | Account ID of the assignee | Use jira_search to resolve names → IDs |
sprint | Sprint ID (not name) | Retrieve via board/sprint API |
story_points / customfield_XXXXX | Estimation | Fibonacci: 1, 2, 3, 5, 8, 13 |
epic_link / customfield_XXXXX | Parent Epic key | PROJ-42 |
fix_versions | Target release versions | ["v2.1.0"] |
Story Description:
h2. User Story
As a [persona], I want [action] so that [benefit].
h2. Acceptance Criteria
* [ ] Criterion 1
* [ ] Criterion 2
* [ ] Criterion 3
h2. Technical Notes
* Implementation approach or constraints
* Relevant endpoints, schemas, dependencies
h2. Out of Scope
* What this story explicitly does NOT coverBug Description:
h2. Summary
Brief description of the defect.
h2. Steps to Reproduce
# Step 1
# Step 2
# Step 3
h2. Expected Behavior
What should happen.
h2. Actual Behavior
What actually happens. Include error messages, status codes, screenshots.
h2. Environment
* Browser/OS/Device:
* Version/Build:
* Environment: staging / production
h2. Severity Assessment
* Impact: [Critical / High / Medium / Low]
* Frequency: [Always / Often / Sometimes / Rarely]
* Workaround: [None / Exists — describe]To Do → In Progress → In Review → Done| State | Meaning | Transition Trigger |
|---|---|---|
| To Do | Work not started, in backlog or sprint | Issue created or moved to sprint |
| In Progress | Actively being worked on | Developer starts work |
| In Review | Code complete, awaiting review | PR opened or review requested |
| Done | Accepted and complete | PR merged, QA passed |
| Link Type | Forward Description | Reverse Description | When to Use |
|---|---|---|---|
| Blocks | blocks | is blocked by | Issue A must complete before B can start |
| Relates to | relates to | relates to | Loosely related work, shared context |
| Duplicates | duplicates | is duplicated by | Same defect reported twice |
| Clones | clones | is cloned by | Copy of an issue for another project/sprint |
| Causes | causes | is caused by | Root cause relationship (bugs) |
jira_create_issueCreate a new Jira issue.
Parameters: project, summary, issuetype, description?, priority?, labels?, components?, assignee?, parent? (for sub-tasks)
Returns: key, id, self (URL)jira_update_issueUpdate fields on an existing issue.
Parameters: issue_key, fields (object with fields to update)
Returns: confirmationjira_add_commentAdd a comment to an existing issue.
Parameters: issue_key, body (comment text)
Returns: comment ID, created timestampjira_link_issuesCreate a link between two issues.
Parameters: inward_issue, outward_issue, link_type
Returns: confirmationjira_searchSearch issues using JQL.
Parameters: jql, fields? (array of field names), max_results?
Returns: array of matching issuesjira_get_issueRetrieve full details of a single issue.
Parameters: issue_key
Returns: full issue object with all fieldsjira_transition_issueMove an issue to a new workflow state.
Parameters: issue_key, transition_id or transition_name
Returns: confirmation-- My open issues
assignee = currentUser() AND status != Done
-- Sprint backlog
sprint in openSprints() AND project = PROJ
-- Unresolved bugs by priority
project = PROJ AND issuetype = Bug AND status != Done ORDER BY priority ASC
-- Recently updated
project = PROJ AND updated >= -7d ORDER BY updated DESC
-- Blocked work
issuefunction in hasLinks("is blocked by")
-- Epics missing stories
issuetype = Epic AND project = PROJ AND NOT issuefunction in hasLinks("is Epic of")
-- Issues without estimates
project = PROJ AND issuetype in (Story, Task) AND story_points is EMPTY AND sprint in openSprints()| Operator | Example | Notes |
|---|---|---|
=, != | status = "In Progress" | Exact match |
in, not in | issuetype in (Story, Bug) | Multiple values |
~ | summary ~ "auth" | Contains text (fuzzy) |
is EMPTY / is not EMPTY | assignee is EMPTY | Null checks |
>=, <= | created >= -30d | Date/number comparison |
was, was in, was not | status was "In Progress" | Historical state |
changed | status changed FROM "To Do" TO "In Progress" | Transition history |
ORDER BY | ORDER BY priority ASC, created DESC | Sorting |
| Function | Purpose |
|---|---|
currentUser() | The authenticated user |
openSprints() | All active sprints |
closedSprints() | All completed sprints |
futureSprints() | All upcoming sprints |
startOfDay(), endOfDay() | Day boundaries |
startOfWeek(), endOfWeek() | Week boundaries |
now() | Current timestamp |
references/. Changes to SKILL.md or scripts/ require user approval.~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.