{"id":40252525,"url":"https://github.com/netresearch/jira-skill","last_synced_at":"2026-04-01T21:37:35.917Z","repository":{"id":323005601,"uuid":"1091651246","full_name":"netresearch/jira-skill","owner":"netresearch","description":"Agent Skill for intelligent Jira integration with MCP config and wiki markup | Claude Code compatible","archived":false,"fork":false,"pushed_at":"2026-03-29T01:30:26.000Z","size":384,"stargazers_count":37,"open_issues_count":1,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-29T01:46:34.204Z","etag":null,"topics":["agent-skills","ai-agent","atlassian","claude-code-skill","jira","mcp","open-standard","project-management","skill"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netresearch.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-07T10:15:13.000Z","updated_at":"2026-03-29T01:30:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/netresearch/jira-skill","commit_stats":null,"previous_names":["netresearch/jira-skill"],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/netresearch/jira-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fjira-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fjira-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fjira-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fjira-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/jira-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fjira-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agent","atlassian","claude-code-skill","jira","mcp","open-standard","project-management","skill"],"created_at":"2026-01-20T01:23:31.983Z","updated_at":"2026-04-01T21:37:35.909Z","avatar_url":"https://github.com/netresearch.png","language":"Python","readme":"# Jira Integration Plugin for Claude Code\n\n[![CI](https://github.com/netresearch/jira-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/netresearch/jira-skill/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/License-MIT%20%2B%20CC--BY--SA--4.0-blue.svg)](#license)\n[![Python](https://img.shields.io/badge/python-3.10%7C3.11%7C3.12%7C3.13-blue)](https://www.python.org/)\n\nA Claude Code plugin providing comprehensive Jira integration through two specialized skills.\n\n## Plugin Structure\n\n| Skill | Purpose |\n|-------|---------|\n| `jira-communication` | API operations via Python CLI scripts |\n| `jira-syntax` | Wiki markup syntax, templates, validation |\n\nEach skill has its own `SKILL.md` with trigger conditions and usage instructions. Claude Code auto-discovers and activates skills based on context.\n\n## 🔌 Skill Compatibility\n\nThe skills contained in this plugin follow the [Agent Skills open standard](https://agentskills.io) originally developed by Anthropic and released for cross-platform use.\n\n**Supported Platforms:**\n- ✅ Claude Code (Anthropic)\n- ✅ Cursor\n- ✅ GitHub Copilot\n- ✅ Other skills-compatible AI agents\n\n\u003e Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.\n\n\n## Features\n\n- **Zero MCP overhead** - Scripts invoked via Bash, no tool descriptions loaded\n- **Fast execution** - No Docker container spin-up\n- **Full API coverage** - All common Jira operations supported\n- **Jira Server/DC + Cloud** - Works with both deployment types\n\n## Installation\n\n### Marketplace (Recommended)\n\nAdd the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:\n\n```bash\n# Claude Code\n/plugin marketplace add netresearch/claude-code-marketplace\n```\n\n### npx ([skills.sh](https://skills.sh))\n\nInstall with any [Agent Skills](https://agentskills.io)-compatible agent:\n\n```bash\nnpx skills add https://github.com/netresearch/jira-skill --skill jira-communication\nnpx skills add https://github.com/netresearch/jira-skill --skill jira-syntax\n```\n\n### Download Release\n\nDownload the [latest release](https://github.com/netresearch/jira-skill/releases/latest) and extract to your agent's skills directory.\n\n### Git Clone\n\n```bash\ngit clone https://github.com/netresearch/jira-skill.git\n```\n\n### Composer (PHP Projects)\n\n```bash\ncomposer require netresearch/jira-skill\n```\n\nRequires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).\n## Quick Start\n\n\u003e **Note:** Run commands from `skills/jira-communication/`, or prefix paths with `skills/jira-communication/` from the repo root.\n\n```bash\n# Search issues\nuv run scripts/core/jira-search.py query \"project = PROJ AND status = 'In Progress'\"\n\n# Get issue details\nuv run scripts/core/jira-issue.py get PROJ-123\n\n# Add worklog\nuv run scripts/core/jira-worklog.py add PROJ-123 \"2h 30m\" -c \"Code review\"\n\n# Create issue\nuv run scripts/workflow/jira-create.py issue PROJ \"Fix bug\" --type Bug --priority High\n```\n\n## Available Scripts\n\n### Core Operations (scripts/core/)\n\n| Script | Commands | Usage |\n|--------|----------|-------|\n| `jira-setup.py` | (default) | Interactive credential setup |\n| `jira-validate.py` | (default) | Validate environment setup |\n| `jira-issue.py` | get, update | Get and update issues |\n| `jira-search.py` | query | JQL search |\n| `jira-worklog.py` | add, list | Time tracking |\n| `jira-attachment.py` | download | Download issue attachments |\n\n### Workflow Operations (scripts/workflow/)\n\n| Script | Commands | Usage |\n|--------|----------|-------|\n| `jira-create.py` | issue | Create new issues |\n| `jira-transition.py` | list, do | Change issue status |\n| `jira-comment.py` | add, list | Issue comments |\n| `jira-sprint.py` | list, issues, current | Sprint operations |\n| `jira-board.py` | list, issues | Board operations |\n\n### Utility Operations (scripts/utility/)\n\n| Script | Commands | Usage |\n|--------|----------|-------|\n| `jira-fields.py` | search, list | Find field IDs |\n| `jira-user.py` | me, get | User information |\n| `jira-link.py` | create, list-types | Issue linking |\n\n## Common Options\n\nAll scripts support:\n\n- `--json` - Output as JSON\n- `--quiet` / `-q` - Minimal output\n- `--env-file PATH` - Custom environment file\n- `--debug` - Show detailed errors\n- `--help` - Show command help\n\nWrite operations also support:\n\n- `--dry-run` - Preview changes without executing\n\n## Script Usage Examples\n\n### Search and Filter\n\n```bash\n# Find open bugs in project\nuv run scripts/core/jira-search.py query \"project = PROJ AND type = Bug AND status != Done\"\n\n# Find my assigned issues\nuv run scripts/core/jira-search.py query \"assignee = currentUser()\"\n\n# Output as JSON for processing\nuv run scripts/core/jira-search.py query \"project = PROJ\" --json --max-results 100\n```\n\n### Issue Management\n\n```bash\n# Get issue details\nuv run scripts/core/jira-issue.py get PROJ-123\n\n# Update issue fields (dry-run first)\nuv run scripts/core/jira-issue.py update PROJ-123 --labels \"urgent,backend\" --dry-run\n\n# Create new issue\nuv run scripts/workflow/jira-create.py issue PROJ \"Implement feature X\" --type Story --priority Medium\n```\n\n### Time Tracking\n\n```bash\n# Log time worked\nuv run scripts/core/jira-worklog.py add PROJ-123 \"2h 30m\" -c \"Implemented core logic\"\n\n# View worklogs\nuv run scripts/core/jira-worklog.py list PROJ-123\n```\n\n### Workflow Transitions\n\n```bash\n# List available transitions\nuv run scripts/workflow/jira-transition.py list PROJ-123\n\n# Transition issue (dry-run first)\nuv run scripts/workflow/jira-transition.py do PROJ-123 \"In Progress\" --dry-run\n\n# Execute transition\nuv run scripts/workflow/jira-transition.py do PROJ-123 \"In Progress\"\n```\n\n### Comments\n\n```bash\n# Add comment\nuv run scripts/workflow/jira-comment.py add PROJ-123 \"Investigation complete - root cause identified\"\n\n# List recent comments\nuv run scripts/workflow/jira-comment.py list PROJ-123 --limit 5\n```\n\n### Sprint \u0026 Board Operations\n\n```bash\n# List boards for project\nuv run scripts/workflow/jira-board.py list --project PROJ\n\n# Get board issues\nuv run scripts/workflow/jira-board.py issues 42\n\n# List sprints\nuv run scripts/workflow/jira-sprint.py list 42 --state active\n\n# Get sprint issues\nuv run scripts/workflow/jira-sprint.py issues 123\n\n# Get current sprint\nuv run scripts/workflow/jira-sprint.py current 42\n```\n\n### Utility Operations\n\n```bash\n# Search for custom fields\nuv run scripts/utility/jira-fields.py search \"story points\"\n\n# List all custom fields\nuv run scripts/utility/jira-fields.py list --type custom\n\n# Get current user info\nuv run scripts/utility/jira-user.py me\n\n# List available link types\nuv run scripts/utility/jira-link.py list-types\n\n# Create issue link\nuv run scripts/utility/jira-link.py create PROJ-123 PROJ-456 --type \"Blocks\" --dry-run\n```\n\n## Related Skills\n\n- **jira-syntax** - Jira wiki markup validation and templates (unchanged)\n\n## Troubleshooting\n\n### \"uv not found\"\n\nInstall uv:\n```bash\npip install uv\n```\n\n### \"Environment file not found\"\n\nCreate `~/.env.jira` with your credentials.\n\n### \"Authentication failed\"\n\n1. Verify JIRA_URL is correct\n2. For Cloud: JIRA_USERNAME is your email\n3. For Server/DC: Use JIRA_PERSONAL_TOKEN instead\n4. Regenerate your API token if expired\n\n### Import errors when running scripts\n\nRun scripts from the skill directory:\n```bash\ncd skills/jira-communication\nuv run scripts/core/jira-issue.py get PROJ-123\n```\n\n## License\n\nMIT\n\n## Credits\n\nDeveloped and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).\n\n---\n\n**Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fjira-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Fjira-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fjira-skill/lists"}