aiskillstore/marketplace / skills/89jobrien/jira
jira
VerifiedJira Cloud integration for issue management and search. This skill should be used when working with Jira tickets, searching issues with JQL, creating or updating issues, adding comments, or transitioning issue status. Covers REST API v3 and Jira Query Language.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.5 KB |
| references/adf-format.md | markdown | 4.4 KB |
| references/api-endpoints.md | markdown | 3.2 KB |
| references/jql-reference.md | markdown | 4.6 KB |
| scripts/jira-api.pyexecutable | script | 4.5 KB |
| skill-report.json | config | 70.1 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T12:41:09.142Z",
"slug": "89jobrien-jira",
"source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/jira",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "50bb30c0251685cd43680e3e6b3908cda152932795734a7927f7026e60c440ef",
"tree_hash": "8b5e46c69a8a800955435574c5aebe6e4fc9cbbb6d46b62527b1688e14031c19",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "jira",
"description": "Jira Cloud integration for searching issues, reading ticket details, creating and updating issues, adding comments, assigning work, and moving issues through Jira workflows with REST API v3 and JQL.",
"summary": "Manage Jira Cloud issues with REST API v3, JQL, and ADF guidance.",
"icon": "📦",
"version": "1.0.2",
"author": "Joseph OBrien",
"license": "MIT",
"tags": [
"jira",
"atlassian",
"jql",
"issue-tracking",
"project-management"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"network",
"external_commands",
"env_access"
],
"category": "productivity"
},
"security_audit": {
"risk_level": "high",
"is_blocked": false,
"safe_to_publish": false,
"analysis_status": "ok",
"summary": "The skill is a legitimate Jira Cloud helper, and most markdown backtick findings are false positives from examples and inline references. It still handles Jira API credentials, reads .env configuration, and makes authenticated outbound requests. The main security concern is that JIRA_DOMAIN is not validated before credentials are sent.",
"remediation": [
{
"issue": "Jira domain is not validated before authenticated requests.",
"suggestion": "Require HTTPS and restrict JIRA_DOMAIN to Atlassian Cloud domains or an explicit user-approved allowlist before sending Authorization headers.",
"severity": "high"
},
{
"issue": "The helper automatically reads a .env file from the current working directory.",
"suggestion": "Load only the required JIRA_DOMAIN, JIRA_EMAIL, and JIRA_API_TOKEN keys from an explicit config path, and document secret storage expectations.",
"severity": "high"
},
{
"issue": "Shell examples derive Basic Auth values from Jira credentials.",
"suggestion": "Prefer helper-script usage and warn users not to paste tokens into shared shells, logs, committed files, or prompts.",
"severity": "medium"
}
],
"risk_factor_evidence": [
{
"factor": "network",
"evidence": [
{
"file": "references/adf-format.md",
"line_start": 180,
"line_end": 180
},
{
"file": "scripts/jira-api.py",
"line_start": 85,
"line_end": 85
},
{
"file": "scripts/jira-api.py",
"line_start": 151,
"line_end": 151
},
{
"file": "scripts/jira-api.py",
"line_start": 38,
"line_end": 38
},
{
"file": "scripts/jira-api.py",
"line_start": 106,
"line_end": 106
},
{
"file": "scripts/jira-api.py",
"line_start": 109,
"line_end": 109
},
{
"file": "scripts/jira-api.py",
"line_start": 80,
"line_end": 80
},
{
"file": "SKILL.md",
"line_start": 29,
"line_end": 29
},
{
"file": "SKILL.md",
"line_start": 161,
"line_end": 161
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "references/api-endpoints.md",
"line_start": 20,
"line_end": 20
},
{
"file": "SKILL.md",
"line_start": 21,
"line_end": 21
},
{
"file": "SKILL.md",
"line_start": 23,
"line_end": 27
},
{
"file": "SKILL.md",
"line_start": 27,
"line_end": 37
},
{
"file": "SKILL.md",
"line_start": 37,
"line_end": 39
},
{
"file": "SKILL.md",
"line_start": 39,
"line_end": 43
},
{
"file": "SKILL.md",
"line_start": 43,
"line_end": 45
},
{
"file": "SKILL.md",
"line_start": 45,
"line_end": 51
},
{
"file": "SKILL.md",
"line_start": 51,
"line_end": 53
},
{
"file": "SKILL.md",
"line_start": 53,
"line_end": 55
},
{
"file": "SKILL.md",
"line_start": 55,
"line_end": 57
},
{
"file": "SKILL.md",
"line_start": 57,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 59
},
{
"file": "SKILL.md",
"line_start": 59,
"line_end": 63
},
{
"file": "SKILL.md",
"line_start": 63,
"line_end": 65
},
{
"file": "SKILL.md",
"line_start": 65,
"line_end": 83
},
{
"file": "SKILL.md",
"line_start": 83,
"line_end": 89
},
{
"file": "SKILL.md",
"line_start": 89,
"line_end": 96
},
{
"file": "SKILL.md",
"line_start": 96,
"line_end": 102
},
{
"file": "SKILL.md",
"line_start": 102,
"line_end": 115
},
{
"file": "SKILL.md",
"line_start": 115,
"line_end": 121
},
{
"file": "SKILL.md",
"line_start": 121,
"line_end": 123
},
{
"file": "SKILL.md",
"line_start": 123,
"line_end": 127
},
{
"file": "SKILL.md",
"line_start": 127,
"line_end": 131
},
{
"file": "SKILL.md",
"line_start": 131,
"line_end": 137
},
{
"file": "SKILL.md",
"line_start": 137,
"line_end": 145
},
{
"file": "SKILL.md",
"line_start": 145,
"line_end": 149
},
{
"file": "SKILL.md",
"line_start": 149,
"line_end": 151
},
{
"file": "SKILL.md",
"line_start": 151,
"line_end": 157
},
{
"file": "SKILL.md",
"line_start": 157,
"line_end": 164
},
{
"file": "SKILL.md",
"line_start": 164,
"line_end": 168
},
{
"file": "SKILL.md",
"line_start": 168,
"line_end": 169
},
{
"file": "SKILL.md",
"line_start": 169,
"line_end": 170
},
{
"file": "SKILL.md",
"line_start": 170,
"line_end": 178
},
{
"file": "SKILL.md",
"line_start": 178,
"line_end": 180
},
{
"file": "SKILL.md",
"line_start": 180,
"line_end": 186
},
{
"file": "SKILL.md",
"line_start": 186,
"line_end": 189
},
{
"file": "SKILL.md",
"line_start": 189,
"line_end": 193
},
{
"file": "SKILL.md",
"line_start": 193,
"line_end": 195
},
{
"file": "SKILL.md",
"line_start": 159,
"line_end": 159
},
{
"file": "SKILL.md",
"line_start": 157,
"line_end": 164
}
]
},
{
"factor": "env_access",
"evidence": [
{
"file": "scripts/jira-api.py",
"line_start": 52,
"line_end": 52
},
{
"file": "scripts/jira-api.py",
"line_start": 53,
"line_end": 53
},
{
"file": "scripts/jira-api.py",
"line_start": 58,
"line_end": 58
},
{
"file": "scripts/jira-api.py",
"line_start": 59,
"line_end": 59
},
{
"file": "scripts/jira-api.py",
"line_start": 74,
"line_end": 74
}
]
}
],
"static_findings": [
{
"id": "network:references/adf-format.md:180:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "references/adf-format.md",
"line_start": 180,
"line_end": 180,
"snippet": "\"attrs\": { \"href\": \"https://example.com\" }"
},
{
"id": "blocker:references/adf-format.md:310:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/adf-format.md",
"line_start": 310,
"line_end": 310,
"snippet": "3. Empty content arrays are invalid - omit the field or include content"
},
{
"id": "external_commands:references/api-endpoints.md:20:shell-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Shell command substitution",
"file": "references/api-endpoints.md",
"line_start": 20,
"line_end": 20,
"snippet": "AUTH=$(echo -n \"email@example.com:API_TOKEN\" | base64)"
},
{
"id": "network:scripts/jira-api.py:85:http-client-library",
"category": "network",
"severity": "low",
"pattern": "HTTP client library",
"file": "scripts/jira-api.py",
"line_start": 85,
"line_end": 85,
"snippet": "def make_request(method, endpoint, data=None, query=None):"
},
{
"id": "network:scripts/jira-api.py:151:http-client-library",
"category": "network",
"severity": "low",
"pattern": "HTTP client library",
"file": "scripts/jira-api.py",
"line_start": 151,
"line_end": 151,
"snippet": "result = make_request(args.method, args.endpoint, data, args.query)"
},
{
"id": "network:scripts/jira-api.py:38:python-http-libraries",
"category": "network",
"severity": "low",
"pattern": "Python HTTP libraries",
"file": "scripts/jira-api.py",
"line_start": 38,
"line_end": 38,
"snippet": "import urllib.request"
},
{
"id": "network:scripts/jira-api.py:106:python-http-libraries",
"category": "network",
"severity": "low",
"pattern": "Python HTTP libraries",
"file": "scripts/jira-api.py",
"line_start": 106,
"line_end": 106,
"snippet": "req = urllib.request.Request(url, data=body, headers=headers, method=method)"
},
{
"id": "network:scripts/jira-api.py:109:python-http-libraries",
"category": "network",
"severity": "low",
"pattern": "Python HTTP libraries",
"file": "scripts/jira-api.py",
"line_start": 109,
"line_end": 109,
"snippet": "with urllib.request.urlopen(req) as response:"
},
{
"id": "network:scripts/jira-api.py:80:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "scripts/jira-api.py",
"line_start": 80,
"line_end": 80,
"snippet": "domain = f\"https://{domain}\""
},
{
"id": "env_access:scripts/jira-api.py:52:python-environment-access",
"category": "env_access",
"severity": "low",
"pattern": "Python environment access",
"file": "scripts/jira-api.py",
"line_start": 52,
"line_end": 52,
"snippet": "if key not in os.environ:"
},
{
"id": "env_access:scripts/jira-api.py:53:python-environment-access",
"category": "env_access",
"severity": "low",
"pattern": "Python environment access",
"file": "scripts/jira-api.py",
"line_start": 53,
"line_end": 53,
"snippet": "os.environ[key] = value"
},
{
"id": "env_access:scripts/jira-api.py:58:python-environment-access",
"category": "env_access",
"severity": "low",
"pattern": "Python environment access",
"file": "scripts/jira-api.py",
"line_start": 58,
"line_end": 58,
"snippet": "email = os.environ.get(\"JIRA_EMAIL\")"
},
{
"id": "env_access:scripts/jira-api.py:59:python-environment-access",
"category": "env_access",
"severity": "low",
"pattern": "Python environment access",
"file": "scripts/jira-api.py",
"line_start": 59,
"line_end": 59,
"snippet": "token = os.environ.get(\"JIRA_API_TOKEN\")"
},
{
"id": "env_access:scripts/jira-api.py:74:python-environment-access",
"category": "env_access",
"severity": "low",
"pattern": "Python environment access",
"file": "scripts/jira-api.py",
"line_start": 74,
"line_end": 74,
"snippet": "domain = os.environ.get(\"JIRA_DOMAIN\")"
},
{
"id": "sensitive:scripts/jira-api.py:25:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "scripts/jira-api.py",
"line_start": 25,
"line_end": 25,
"snippet": "Environment variables (or .env file):"
},
{
"id": "sensitive:scripts/jira-api.py:43:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "scripts/jira-api.py",
"line_start": 43,
"line_end": 43,
"snippet": "\"\"\"Load environment variables from .env file if present.\"\"\""
},
{
"id": "sensitive:scripts/jira-api.py:44:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "scripts/jira-api.py",
"line_start": 44,
"line_end": 44,
"snippet": "env_file = Path.cwd() / \".env\""
},
{
"id": "blocker:scripts/jira-api.py:148:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "scripts/jira-api.py",
"line_start": 148,
"line_end": 148,
"snippet": "print(\"Error: Invalid JSON data\", file=sys.stderr)"
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 21,
"line_end": 21,
"snippet": "Set these environment variables (or in `.env` file):"
},
{
"id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 23,
"line_end": 27,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 27,
"line_end": 37,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 37,
"line_end": 39,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 39,
"line_end": 43,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 43,
"line_end": 45,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 45,
"line_end": 51,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 51,
"line_end": 53,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 53,
"line_end": 55,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 55,
"line_end": 57,
"snippet": "Common JQL patterns - see `references/jql-reference.md`:"
},
{
"id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 57,
"line_end": 58,
"snippet": "- My open issues: `assignee = currentUser() AND resolution = Unresolved`"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 59,
"snippet": "- Recent updates: `updated >= -1d ORDER BY updated DESC`"
},
{
"id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 59,
"line_end": 63,
"snippet": "- Sprint work: `sprint in openSprints() AND assignee = currentUser()`"
},
{
"id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 63,
"line_end": 65,
"snippet": "To create a new issue, use ADF format for description (see `references/adf-format.md`):"
},
{
"id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 65,
"line_end": 83,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 83,
"line_end": 89,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 89,
"line_end": 96,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 96,
"line_end": 102,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 102,
"line_end": 115,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 115,
"line_end": 121,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:121:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 121,
"line_end": 123,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 123,
"line_end": 127,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:127:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 127,
"line_end": 131,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 131,
"line_end": 137,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 137,
"line_end": 145,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 145,
"line_end": 149,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 149,
"line_end": 151,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 151,
"line_end": 157,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 157,
"line_end": 164,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:164:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 164,
"line_end": 168,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 168,
"line_end": 169,
"snippet": "- **`references/api-endpoints.md`** - Complete REST API v3 endpoint reference"
},
{
"id": "external_commands:SKILL.md:169:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 169,
"line_end": 170,
"snippet": "- **`references/jql-reference.md`** - JQL operators, functions, fields, and patterns"
},
{
"id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 170,
"line_end": 178,
"snippet": "- **`references/adf-format.md`** - Atlassian Document Format for rich text fields"
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 178,
"line_end": 180,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 180,
"line_end": 186,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:186:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 186,
"line_end": 189,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 189,
"line_end": 193,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 193,
"line_end": 195,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:159:shell-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Shell command substitution",
"file": "SKILL.md",
"line_start": 159,
"line_end": 159,
"snippet": "AUTH=$(echo -n \"$JIRA_EMAIL:$JIRA_API_TOKEN\" | base64)"
},
{
"id": "external_commands:SKILL.md:157:template-literal-with-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Template literal with command substitution",
"file": "SKILL.md",
"line_start": 157,
"line_end": 164,
"snippet": "```bash"
},
{
"id": "network:SKILL.md:29:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 29,
"line_end": 29,
"snippet": "Generate API tokens at: <https://id.atlassian.com/manage-profile/security/api-tokens>"
},
{
"id": "network:SKILL.md:161:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 161,
"line_end": 161,
"snippet": "curl -s \"https://$JIRA_DOMAIN/rest/api/3/issue/PROJ-123\" \\"
},
{
"id": "sensitive:SKILL.md:21:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "SKILL.md",
"line_start": 21,
"line_end": 21,
"snippet": "Set these environment variables (or in `.env` file):"
}
],
"finding_verdicts": [
{
"id": "network:references/adf-format.md:180:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The URL appears inside an Atlassian Document Format link example using example.com. It is documentation data, not a live network request."
},
{
"id": "blocker:references/adf-format.md:310:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The line is an ADF validation tip about empty content arrays. It contains no reconnaissance command or system inspection behavior."
},
{
"id": "external_commands:references/api-endpoints.md:20:shell-command-substitution",
"verdict": "confirmed",
"confidence": 0.72,
"reason": "The example builds a Basic Auth value from an email and API token in the shell. This is legitimate Jira documentation, but it handles credentials and can expose them if copied into unsafe shell history or logs.",
"severity": "medium"
},
{
"id": "network:scripts/jira-api.py:85:http-client-library",
"verdict": "confirmed",
"confidence": 0.88,
"reason": "make_request constructs authenticated outbound Jira API calls. Network access is expected for this skill, but it sends credentials to the configured remote host.",
"severity": "low"
},
{
"id": "network:scripts/jira-api.py:151:http-client-library",
"verdict": "confirmed",
"confidence": 0.86,
"reason": "The CLI dispatches user-selected methods and endpoints to make_request. This is intended Jira functionality, but it performs authenticated outbound requests.",
"severity": "low"
},
{
"id": "network:scripts/jira-api.py:38:python-http-libraries",
"verdict": "confirmed",
"confidence": 0.83,
"reason": "urllib.request is imported to perform Jira Cloud HTTP requests. The library use is expected, but it enables outbound network communication.",
"severity": "low"
},
{
"id": "network:scripts/jira-api.py:106:python-http-libraries",
"verdict": "confirmed",
"confidence": 0.9,
"reason": "The script creates a urllib request containing the Authorization header. This is real network behavior with credential-bearing headers.",
"severity": "low"
},
{
"id": "network:scripts/jira-api.py:109:python-http-libraries",
"verdict": "confirmed",
"confidence": 0.9,
"reason": "The script opens the urllib request and sends it over the network. This is expected for Jira access, but it is authenticated outbound traffic.",
"severity": "low"
},
{
"id": "network:scripts/jira-api.py:80:hardcoded-url",
"verdict": "confirmed",
"confidence": 0.84,
"reason": "The script prepends https to the configured Jira domain before making API calls. This is legitimate, but the resulting host controls where credentials are sent.",
"severity": "low"
},
{
"id": "env_access:scripts/jira-api.py:52:python-environment-access",
"verdict": "confirmed",
"confidence": 0.76,
"reason": "The script checks process environment keys while importing values from a .env file. This is intended configuration handling, but it touches sensitive runtime state.",
"severity": "low"
},
{
"id": "env_access:scripts/jira-api.py:53:python-environment-access",
"verdict": "confirmed",
"confidence": 0.78,
"reason": "The script writes parsed .env values into os.environ. That can affect credential resolution for the authenticated Jira request.",
"severity": "low"
},
{
"id": "env_access:scripts/jira-api.py:58:python-environment-access",
"verdict": "confirmed",
"confidence": 0.88,
"reason": "The script reads JIRA_EMAIL from the environment for Basic Auth. This is required behavior, but it handles account-identifying credential material.",
"severity": "low"
},
{
"id": "env_access:scripts/jira-api.py:59:python-environment-access",
"verdict": "confirmed",
"confidence": 0.9,
"reason": "The script reads JIRA_API_TOKEN from the environment for Basic Auth. This is sensitive credential access even though it is expected for Jira API use.",
"severity": "low"
},
{
"id": "env_access:scripts/jira-api.py:74:python-environment-access",
"verdict": "confirmed",
"confidence": 0.86,
"reason": "The script reads JIRA_DOMAIN from the environment to decide the remote API host. A wrong or malicious value changes where authenticated requests go.",
"severity": "low"
},
{
"id": "sensitive:scripts/jira-api.py:25:environment-file-access",
"verdict": "confirmed",
"confidence": 0.72,
"reason": "The script documentation explicitly supports credentials in a .env file. This is a common pattern, but it encourages local storage of Jira API tokens.",
"severity": "high"
},
{
"id": "sensitive:scripts/jira-api.py:43:environment-file-access",
"verdict": "confirmed",
"confidence": 0.84,
"reason": "load_env is dedicated to loading values from a .env file. Because those values include Jira credentials, this is sensitive file handling.",
"severity": "high"
},
{
"id": "sensitive:scripts/jira-api.py:44:environment-file-access",
"verdict": "confirmed",
"confidence": 0.86,
"reason": "The helper reads a .env file from the current working directory. That file can contain API tokens and domain configuration used in outbound requests.",
"severity": "high"
},
{
"id": "blocker:scripts/jira-api.py:148:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The line prints an invalid JSON error to stderr. It does not collect host, user, process, or system information."
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:121:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:127:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:164:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:169:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:186:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The flagged backticks are markdown code fences or inline documentation markers in SKILL.md. They are not Ruby backtick execution and do not execute commands by themselves."
},
{
"id": "external_commands:SKILL.md:159:shell-command-substitution",
"verdict": "confirmed",
"confidence": 0.74,
"reason": "The curl example builds a Basic Auth value from Jira credentials using shell command substitution. It is legitimate, but copied commands can expose credential-derived values in shell contexts.",
"severity": "medium"
},
{
"id": "external_commands:SKILL.md:157:template-literal-with-command-substitution",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "The flagged line is the opening marker for a markdown bash block. The actual shell substitution is adjudicated separately at line 159."
},
{
"id": "network:SKILL.md:29:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The URL points to Atlassian account settings for generating API tokens. It is a user documentation link, not hidden outbound behavior."
},
{
"id": "network:SKILL.md:161:hardcoded-url",
"verdict": "confirmed",
"confidence": 0.78,
"reason": "The curl example sends an authenticated request to the configured Jira Cloud domain. This is intended, but it is still credential-bearing outbound network access.",
"severity": "low"
},
{
"id": "sensitive:SKILL.md:21:environment-file-access",
"verdict": "confirmed",
"confidence": 0.8,
"reason": "The skill instructs users to place Jira credentials in environment variables or a .env file. This is expected setup, but it creates secret-handling risk for users.",
"severity": "high"
}
],
"semantic_findings": [
{
"title": "Unvalidated Jira Domain Can Receive Credentials",
"description": "The helper reads JIRA_DOMAIN from the environment, accepts arbitrary http-prefixed values, and sends the Basic Auth header to the resulting host. A mistaken or malicious domain value could receive the Jira email and API token.",
"severity": "high",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 72,
"line_end": 82
},
{
"file": "scripts/jira-api.py",
"line_start": 93,
"line_end": 106
}
],
"confidence": 0.86,
"confidence_reasoning": "The code directly derives the base URL from JIRA_DOMAIN and attaches Basic Auth headers before creating the request. This is legitimate Jira functionality, but the missing host allowlist creates a clear credential exposure risk."
}
],
"critical_findings": [],
"high_findings": [
{
"title": "Environment file access",
"description": "Environment variables (or .env file):",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 25,
"line_end": 25
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.72,
"confidence_reasoning": "The script documentation explicitly supports credentials in a .env file. This is a common pattern, but it encourages local storage of Jira API tokens."
},
{
"title": "Environment file access",
"description": "\"\"\"Load environment variables from .env file if present.\"\"\"",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 43,
"line_end": 43
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.84,
"confidence_reasoning": "load_env is dedicated to loading values from a .env file. Because those values include Jira credentials, this is sensitive file handling."
},
{
"title": "Environment file access",
"description": "env_file = Path.cwd() / \".env\"",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 44,
"line_end": 44
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.86,
"confidence_reasoning": "The helper reads a .env file from the current working directory. That file can contain API tokens and domain configuration used in outbound requests."
},
{
"title": "Environment file access",
"description": "Set these environment variables (or in `.env` file):",
"locations": [
{
"file": "SKILL.md",
"line_start": 21,
"line_end": 21
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.8,
"confidence_reasoning": "The skill instructs users to place Jira credentials in environment variables or a .env file. This is expected setup, but it creates secret-handling risk for users."
},
{
"title": "Unvalidated Jira Domain Can Receive Credentials",
"description": "The helper reads JIRA_DOMAIN from the environment, accepts arbitrary http-prefixed values, and sends the Basic Auth header to the resulting host. A mistaken or malicious domain value could receive the Jira email and API token.",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 72,
"line_end": 82
},
{
"file": "scripts/jira-api.py",
"line_start": 93,
"line_end": 106
}
],
"review_kind": "security",
"source_category": "semantic",
"source_severity": "high",
"confidence": 0.86,
"confidence_reasoning": "The code directly derives the base URL from JIRA_DOMAIN and attaches Basic Auth headers before creating the request. This is legitimate Jira functionality, but the missing host allowlist creates a clear credential exposure risk."
}
],
"medium_findings": [
{
"title": "Shell command substitution",
"description": "AUTH=$(echo -n \"email@example.com:API_TOKEN\" | base64)",
"locations": [
{
"file": "references/api-endpoints.md",
"line_start": 20,
"line_end": 20
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.72,
"confidence_reasoning": "The example builds a Basic Auth value from an email and API token in the shell. This is legitimate Jira documentation, but it handles credentials and can expose them if copied into unsafe shell history or logs."
},
{
"title": "Shell command substitution",
"description": "AUTH=$(echo -n \"$JIRA_EMAIL:$JIRA_API_TOKEN\" | base64)",
"locations": [
{
"file": "SKILL.md",
"line_start": 159,
"line_end": 159
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.74,
"confidence_reasoning": "The curl example builds a Basic Auth value from Jira credentials using shell command substitution. It is legitimate, but copied commands can expose credential-derived values in shell contexts."
}
],
"low_findings": [
{
"title": "HTTP client library",
"description": "def make_request(method, endpoint, data=None, query=None):",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 85,
"line_end": 85
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.88,
"confidence_reasoning": "make_request constructs authenticated outbound Jira API calls. Network access is expected for this skill, but it sends credentials to the configured remote host."
},
{
"title": "HTTP client library",
"description": "result = make_request(args.method, args.endpoint, data, args.query)",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 151,
"line_end": 151
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.86,
"confidence_reasoning": "The CLI dispatches user-selected methods and endpoints to make_request. This is intended Jira functionality, but it performs authenticated outbound requests."
},
{
"title": "Python HTTP libraries",
"description": "import urllib.request",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 38,
"line_end": 38
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.83,
"confidence_reasoning": "urllib.request is imported to perform Jira Cloud HTTP requests. The library use is expected, but it enables outbound network communication."
},
{
"title": "Python HTTP libraries",
"description": "req = urllib.request.Request(url, data=body, headers=headers, method=method)",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 106,
"line_end": 106
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.9,
"confidence_reasoning": "The script creates a urllib request containing the Authorization header. This is real network behavior with credential-bearing headers."
},
{
"title": "Python HTTP libraries",
"description": "with urllib.request.urlopen(req) as response:",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 109,
"line_end": 109
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.9,
"confidence_reasoning": "The script opens the urllib request and sends it over the network. This is expected for Jira access, but it is authenticated outbound traffic."
},
{
"title": "Hardcoded URL",
"description": "domain = f\"https://{domain}\"",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 80,
"line_end": 80
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.84,
"confidence_reasoning": "The script prepends https to the configured Jira domain before making API calls. This is legitimate, but the resulting host controls where credentials are sent."
},
{
"title": "Python environment access",
"description": "if key not in os.environ:",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 52,
"line_end": 52
}
],
"review_kind": "capability",
"source_category": "env_access",
"source_severity": "low",
"confidence": 0.76,
"confidence_reasoning": "The script checks process environment keys while importing values from a .env file. This is intended configuration handling, but it touches sensitive runtime state."
},
{
"title": "Python environment access",
"description": "os.environ[key] = value",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 53,
"line_end": 53
}
],
"review_kind": "capability",
"source_category": "env_access",
"source_severity": "low",
"confidence": 0.78,
"confidence_reasoning": "The script writes parsed .env values into os.environ. That can affect credential resolution for the authenticated Jira request."
},
{
"title": "Python environment access",
"description": "email = os.environ.get(\"JIRA_EMAIL\")",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 58,
"line_end": 58
}
],
"review_kind": "capability",
"source_category": "env_access",
"source_severity": "low",
"confidence": 0.88,
"confidence_reasoning": "The script reads JIRA_EMAIL from the environment for Basic Auth. This is required behavior, but it handles account-identifying credential material."
},
{
"title": "Python environment access",
"description": "token = os.environ.get(\"JIRA_API_TOKEN\")",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 59,
"line_end": 59
}
],
"review_kind": "capability",
"source_category": "env_access",
"source_severity": "low",
"confidence": 0.9,
"confidence_reasoning": "The script reads JIRA_API_TOKEN from the environment for Basic Auth. This is sensitive credential access even though it is expected for Jira API use."
},
{
"title": "Python environment access",
"description": "domain = os.environ.get(\"JIRA_DOMAIN\")",
"locations": [
{
"file": "scripts/jira-api.py",
"line_start": 74,
"line_end": 74
}
],
"review_kind": "capability",
"source_category": "env_access",
"source_severity": "low",
"confidence": 0.86,
"confidence_reasoning": "The script reads JIRA_DOMAIN from the environment to decide the remote API host. A wrong or malicious value changes where authenticated requests go."
},
{
"title": "Hardcoded URL",
"description": "curl -s \"https://$JIRA_DOMAIN/rest/api/3/issue/PROJ-123\" \\",
"locations": [
{
"file": "SKILL.md",
"line_start": 161,
"line_end": 161
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.78,
"confidence_reasoning": "The curl example sends an authenticated request to the configured Jira Cloud domain. This is intended, but it is still credential-bearing outbound network access."
}
],
"dangerous_patterns": [],
"files_scanned": 5,
"total_lines": 1123,
"audit_model": "codex",
"audited_at": "2026-07-05T12:41:09.142Z",
"agent_auto_install_policy": "confirmation_required",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Manage Jira Cloud Workflows",
"value_statement": "Teams lose time switching between AI tools and Jira. This skill helps Claude, Codex, and Claude Code search, update, and manage Jira Cloud issues.",
"seo_keywords": [
"Jira Cloud",
"Jira REST API",
"JQL",
"Atlassian",
"issue tracking",
"Claude",
"Codex",
"Claude Code",
"project management",
"ADF comments"
],
"actual_capabilities": [
"Retrieve Jira issue details through Jira Cloud REST API v3.",
"Search Jira issues with JQL queries and common query patterns.",
"Create and update issues with structured Jira field payloads.",
"Add ADF-formatted comments and descriptions to Jira issues.",
"Transition issue status and assign or unassign issues.",
"Reference Jira endpoints, JQL syntax, and Atlassian Document Format examples."
],
"limitations": [
"Requires Jira Cloud network access and valid API credentials.",
"Cannot bypass Jira project permissions, workflow rules, or required fields.",
"Requires valid ADF structure for rich text descriptions and comments.",
"Does not include a graphical Jira client or offline issue cache."
],
"use_cases": [
{
"title": "Triage Sprint Work",
"description": "Find active issues, review owners and status, and identify tickets that need follow-up.",
"target_user": "Engineering lead"
},
{
"title": "Create Structured Tickets",
"description": "Turn requirements into Jira tasks with summaries, labels, priorities, and formatted descriptions.",
"target_user": "Product manager"
},
{
"title": "Automate Routine Updates",
"description": "Add comments, assign tickets, and move issues through configured Jira workflow transitions.",
"target_user": "Developer or support engineer"
}
],
"prompt_templates": [
{
"title": "Find My Open Issues",
"scenario": "Beginner search task",
"prompt": "Search Jira for my unresolved issues in project PROJECT_KEY and summarize priority, status, and latest update."
},
{
"title": "Review One Ticket",
"scenario": "Issue details review",
"prompt": "Get Jira issue PROJECT_KEY-123 and summarize the current status, assignee, blockers, and next useful action."
},
{
"title": "Create a Work Item",
"scenario": "New issue creation",
"prompt": "Create a Jira task in project PROJECT_KEY with this title, acceptance criteria, priority, and labels. Use a valid ADF description."
},
{
"title": "Plan Bulk Triage",
"scenario": "Advanced workflow planning",
"prompt": "Build a JQL query for stale in-progress issues, explain the matching criteria, then propose safe updates for each result."
}
],
"output_examples": [
{
"input": "Find unresolved issues assigned to me in project APP.",
"output": [
"APP-14: Login error is in progress and was updated today.",
"APP-22: Payment timeout is open and has high priority.",
"Suggested next step: review stale issues before changing assignments."
]
},
{
"input": "Summarize APP-123 and suggest the next action.",
"output": "APP-123 is waiting on review. The next action is to add a reviewer note and confirm whether the acceptance criteria are complete."
},
{
"input": "Prepare a comment for the deployment ticket.",
"output": "Prepared a Jira comment with deployment status, validation results, and the remaining owner action in Jira rich text format."
}
],
"best_practices": [
"Use least-privilege Jira API tokens and rotate them on a regular schedule.",
"Preview issue updates before writing comments, assignments, or transitions.",
"Keep JQL queries narrow to avoid large responses and rate limits."
],
"anti_patterns": [
"Do not store Jira API tokens in committed files or shared prompts.",
"Do not run broad update operations without reviewing the affected issue list.",
"Do not use this skill to bypass project permissions or approval workflows."
],
"faq": [
{
"question": "Which Jira version does this skill support?",
"answer": "It targets Jira Cloud REST API v3 and Jira Query Language."
},
{
"question": "Does it create and update Jira issues?",
"answer": "Yes. It includes workflows for creating issues, updating fields, adding comments, assigning users, and changing status."
},
{
"question": "What credentials are required?",
"answer": "It requires a Jira Cloud domain, Jira account email, and Jira API token."
},
{
"question": "Can it format rich text comments?",
"answer": "Yes. It includes Atlassian Document Format guidance for descriptions and comments."
},
{
"question": "Can it work without network access?",
"answer": "No. Jira reads and writes require network access to the configured Jira Cloud site."
},
{
"question": "Does it override Jira permissions?",
"answer": "No. All actions are limited by the permissions of the authenticated Jira account."
}
]
},
"file_structure": [
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "adf-format.md",
"type": "file",
"path": "references/adf-format.md",
"lines": 312
},
{
"name": "api-endpoints.md",
"type": "file",
"path": "references/api-endpoints.md",
"lines": 237
},
{
"name": "jql-reference.md",
"type": "file",
"path": "references/jql-reference.md",
"lines": 209
}
]
},
{
"name": "scripts",
"type": "dir",
"path": "scripts",
"children": [
{
"name": "jira-api.py",
"type": "file",
"path": "scripts/jira-api.py",
"lines": 157
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 208
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |