Atlassian MCP Expert
Jeffallan/claude-skills
Queries and edits Jira issues and Confluence pages through an MCP server, covering JQL and CQL queries, server setup, authentication and sprint or backlog workflows.
在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。
$ npx skills add affaan-m/ECC --skill jira-integration -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install affaan-m/ECC jira-integration --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/zh-CN/skills/jira-integration .claude/skills/jira-integration && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "jira-integration" agent skill from https://github.com/affaan-m/ECC/tree/main/docs/zh-CN/skills/jira-integration into .claude/skills/jira-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "jira-integration", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/affaan-m/ECC/tree/main/docs/zh-CN/skills/jira-integrationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add affaan-m/ECC --skill jira-integration -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install affaan-m/ECC jira-integration --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .agents/skills && cp -r skills-src/docs/zh-CN/skills/jira-integration .agents/skills/jira-integration && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "jira-integration" agent skill from https://github.com/affaan-m/ECC/tree/main/docs/zh-CN/skills/jira-integration into .agents/skills/jira-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "jira-integration", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add affaan-m/ECC --skill jira-integration -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install affaan-m/ECC jira-integration --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/docs/zh-CN/skills/jira-integration .cursor/skills/jira-integration && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "jira-integration" agent skill from https://github.com/affaan-m/ECC/tree/main/docs/zh-CN/skills/jira-integration into .cursor/skills/jira-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "jira-integration", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/affaan-m/ECC.git --path docs/zh-CN/skills/jira-integration--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add affaan-m/ECC --skill jira-integration -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install affaan-m/ECC jira-integration --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/docs/zh-CN/skills/jira-integration .gemini/skills/jira-integration && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "jira-integration" agent skill from https://github.com/affaan-m/ECC/tree/main/docs/zh-CN/skills/jira-integration into .gemini/skills/jira-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "jira-integration", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install affaan-m/ECC jira-integrationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add affaan-m/ECC --skill jira-integration -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .github/skills && cp -r skills-src/docs/zh-CN/skills/jira-integration .github/skills/jira-integration && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "jira-integration" agent skill from https://github.com/affaan-m/ECC/tree/main/docs/zh-CN/skills/jira-integration into .github/skills/jira-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "jira-integration", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add affaan-m/ECC --skill jira-integration -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install affaan-m/ECC jira-integration --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/docs/zh-CN/skills/jira-integration .opencode/skills/jira-integration && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "jira-integration" agent skill from https://github.com/affaan-m/ECC/tree/main/docs/zh-CN/skills/jira-integration into .opencode/skills/jira-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "jira-integration", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
jira-integration在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。
Jira Integration is an agent skill from affaan-m/ECC. 在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Backend & APIs, covering MCP servers. It works with Jira and Model Context Protocol. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.
4 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 4eb71d9. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
jqcurlFrom the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
github.comAlso links to:
id.atlassian.comFrom URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
JIRA_API_TOKENFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Jira Integration loads about 1.5k tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 316 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check noted patterns worth knowing about, such as sudo or a known installer.
* **将 `.env`** 添加到每个项目的 `.gitignore` 中Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from affaan-m/ECC at commit 4eb71d9, republished under its MIT licence (© affaan-m). 316 words, ~1,453 tokens.
.claude/skills/jira-integration/SKILL.md (or your agent's skills folder).直接从 AI 编码工作流中检索、分析和更新 Jira 工单。支持 基于 MCP(推荐)和 直接 REST API 两种方式。
安装 mcp-atlassian MCP 服务器。这将向您的 AI 代理直接暴露 Jira 工具。
要求:
uvx(来自 uv),通过您的包管理器或官方 uv 安装文档进行安装添加到您的 MCP 配置(例如,~/.claude.json → mcpServers):
{
"jira": {
"command": "uvx",
"args": ["mcp-atlassian==0.21.0"],
"env": {
"JIRA_URL": "https://YOUR_ORG.atlassian.net",
"JIRA_EMAIL": "your.email@example.com",
"JIRA_API_TOKEN": "your-api-token"
},
"description": "Jira issue tracking — search, create, update, comment, transition"
}
}安全: 切勿在源代码中硬编码密钥。建议在系统环境(或密钥管理器)中设置
JIRA_URL、JIRA_EMAIL和JIRA_API_TOKEN。仅对本地未提交的配置文件使用 MCPenv块。
获取 Jira API 令牌:
如果 MCP 不可用,可通过 curl 或辅助脚本直接使用 Jira REST API v3。
所需的环境变量:
| 变量 | 描述 |
|---|---|
JIRA_URL | 您的 Jira 实例 URL(例如,https://yourorg.atlassian.net) |
JIRA_EMAIL | 您的 Atlassian 账户邮箱 |
JIRA_API_TOKEN | 来自 id.atlassian.com 的 API 令牌 |
将这些存储在您的 shell 环境、密钥管理器或未跟踪的本地环境文件中。不要将其提交到仓库。
对于直接 curl 示例,请通过标准输入传递 Jira 用户配置,避免凭据出现在命令行参数中。
jira_curl() {
printf 'user = "%s:%s"\n' "$JIRA_EMAIL" "$JIRA_API_TOKEN" |
curl -s -K - "$@"
}当配置了 mcp-atlassian MCP 服务器时,以下工具可用:
| 工具 | 用途 | 示例 |
|---|---|---|
jira_search | JQL 查询 | project = PROJ AND status = "In Progress" |
jira_get_issue | 按键获取完整问题详情 | PROJ-1234 |
jira_create_issue | 创建问题(任务、缺陷、故事、史诗) | 新建缺陷报告 |
jira_update_issue | 更新字段(摘要、描述、经办人) | 更改经办人 |
jira_transition_issue | 更改状态 | 移至“评审中” |
jira_add_comment | 添加评论 | 进度更新 |
jira_get_sprint_issues | 列出冲刺中的问题 | 活跃冲刺评审 |
jira_create_issue_link | 链接问题(阻塞、关联) | 依赖跟踪 |
jira_get_issue_development_info | 查看关联的 PR、分支、提交 | 开发上下文 |
提示: 在转换前始终调用
jira_get_transitions— 转换 ID 因项目工作流而异。
jira_curl \
-H "Content-Type: application/json" \
"$JIRA_URL/rest/api/3/issue/PROJ-1234" | jq '{
key: .key,
summary: .fields.summary,
status: .fields.status.name,
priority: .fields.priority.name,
type: .fields.issuetype.name,
assignee: .fields.assignee.displayName,
labels: .fields.labels,
description: .fields.description
}'jira_curl \
-H "Content-Type: application/json" \
"$JIRA_URL/rest/api/3/issue/PROJ-1234?fields=comment" | jq '.fields.comment.comments[] | {
author: .author.displayName,
created: .created[:10],
body: .body
}'jira_curl -X POST \
-H "Content-Type: application/json" \
-d '{
"body": {
"version": 1,
"type": "doc",
"content": [{
"type": "paragraph",
"content": [{"type": "text", "text": "Your comment here"}]
}]
}
}' \
"$JIRA_URL/rest/api/3/issue/PROJ-1234/comment"# 1. Get available transitions
jira_curl \
"$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions" | jq '.transitions[] | {id, name: .name}'
# 2. Execute transition (replace TRANSITION_ID)
jira_curl -X POST \
-H "Content-Type: application/json" \
-d '{"transition": {"id": "TRANSITION_ID"}}' \
"$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions"jira_curl -G \
--data-urlencode "jql=project = PROJ AND status = 'In Progress'" \
"$JIRA_URL/rest/api/3/search"当为开发或测试自动化检索工单时,提取:
Ticket: PROJ-1234
Summary: [工单标题]
Status: [当前状态]
Priority: [高/中/低]
Test Types: 单元测试, 集成测试, 端到端测试
Requirements:
1. [需求1]
2. [需求2]
Acceptance Criteria:
- [ ] [验收标准1]
- [ ] [验收标准2]
Test Scenarios:
- Happy Path: [描述]
- Error Case: [描述]
- Edge Case: [描述]
Test Data Needed:
- [测试数据1]
- [测试数据2]
Dependencies:
- [依赖项1]
- [依赖项2]| 工作流步骤 | Jira 更新 |
|---|---|
| 开始工作 | 转换为“进行中” |
| 编写测试 | 评论并附上测试覆盖率摘要 |
| 创建分支 | 评论并附上分支名称 |
| 创建 PR/MR | 评论并附上链接,链接问题 |
| 测试通过 | 评论并附上结果摘要 |
| PR/MR 合并 | 转换为“完成”或“评审中” |
开始工作:
开始实现此工单。
分支:feat/PROJ-1234-feature-name测试已实现:
已实现的自动化测试:
单元测试:
- [测试文件1] — [覆盖内容]
- [测试文件2] — [覆盖内容]
集成测试:
- [测试文件] — [覆盖的端点/流程]
所有测试在本地通过。覆盖率:XX%PR 已创建:
Pull request created:
[PR Title](https://github.com/org/repo/pull/XXX)
Ready for review.工作完成:
Implementation complete.
PR merged: [link]
Test results: All passing (X/Y)
Coverage: XX%.env 添加到每个项目的 .gitignore 中| 错误 | 原因 | 修复 |
|---|---|---|
401 Unauthorized | API 令牌无效或已过期 | 在 id.atlassian.com 重新生成 |
403 Forbidden | 令牌缺少项目权限 | 检查令牌范围和项目访问权限 |
404 Not Found | 工单键或基础 URL 错误 | 验证 JIRA_URL 和工单键 |
spawn uvx ENOENT | IDE 在 PATH 中找不到 uvx | 使用完整路径(例如,~/.local/bin/uvx)或在 ~/.zprofile 中设置 PATH |
| 连接超时 | 网络/VPN 问题 | 检查 VPN 连接和防火墙规则 |
© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in docs/zh-CN/skills/jira-integration of affaan-m/ECC.
Open the folder on GitHubat commit 4eb71d9
Jira Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Jira Integration this skillaffaan-m/ECC | 276k | — | ~1.5k | Automated safety check: Notes | MIT | |
| Atlassian MCP ExpertJeffallan/claude-skills | 12k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Atlassiansanjay3290/ai-skills | 432 | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| Jira Natural Language Interfacejjmartres/opencode | 133 | 3 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Work Items To Jiratestdouble/han | 281 | — | ~4.3k | Automated safety check: Pass | MIT | |
| Markdown To Confluencetestdouble/han | 281 | — | ~2.4k | Automated safety check: Pass | MIT |
Jeffallan/claude-skills
Queries and edits Jira issues and Confluence pages through an MCP server, covering JQL and CQL queries, server setup, authentication and sprint or backlog workflows.
sanjay3290/ai-skills
Manage Jira issues and Confluence wiki pages in Atlassian Cloud.
jjmartres/opencode
Lets an agent view, create, update and transition Jira issues in natural language, automatically choosing between the jira CLI and Atlassian MCP tools.
testdouble/han
Break a work-items.md file (produced by /plan-work-items) into independently-grabbable Jira tickets, one per slice, in a single Jira project.
testdouble/han
Publishes a local Markdown file to a user-specified Confluence location, creating a new page or updating an existing one through the Atlassian MCP server.
sundial-org/awesome-openclaw-skills
Run the Model Context Protocol (MCP) Atlassian server in Docker, enabling integration with Jira, Confluence, and other Atlassian products.
affaan-m/ECC
Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.
affaan-m/ECC
Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.
affaan-m/ECC
Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.
affaan-m/ECC
Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.
affaan-m/ECC
Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.
affaan-m/ECC
Set an ECC-specific frontend design direction for production UI work.
Works with
Categories
在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。. Jira Integration is an agent skill from affaan-m/ECC.
Jira Integration fits situations like: tasks that involve MCP servers.
Run `npx skills add affaan-m/ECC --skill jira-integration -a claude-code`. Or copy the skill folder (docs/zh-CN/skills/jira-integration in affaan-m/ECC) into .claude/skills/jira-integration in your project. Claude Code loads it when a task matches its description.
Run `npx skills add affaan-m/ECC --skill jira-integration -a codex`. Or copy the skill folder (docs/zh-CN/skills/jira-integration in affaan-m/ECC) into .agents/skills/jira-integration in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill jira-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/jira-integration, .gemini/skills/jira-integration, .github/skills/jira-integration and .opencode/skills/jira-integration in your project.
Going by SKILL.md and its folder, Jira Integration needs the command-line tools its instructions call (jq and curl) and credentials named JIRA_API_TOKEN. Our summary lists: Python 3; A credential in JIRA_API_TOKEN.
SKILL.md names 2 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: id.atlassian.com. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
Jira Integration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Jira Integration: Atlassian MCP Expert (Jeffallan/claude-skills, 12k stars), Atlassian (sanjay3290/ai-skills, 432 stars), Jira Natural Language Interface (jjmartres/opencode, 133 stars) and Work Items To Jira (testdouble/han, 281 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,111 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 10, 2026.
Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.