Skip to content

netresearch/jira-skill / skills/jira-communication

jira-communication

Flagged

Use when handling Jira issues, sprints, boards, links, fields, worklogs, attachments, or users, or on any Jira intent without a key ("create/find a ticket", "pick a project"). Auto-triggers on Jira URLs and issue keys (PROJ-123). Also use when MCP Atlassian tools fail or are unavailable for Jira Server/DC.

FileKindSize
AGENTS.mdmarkdown2.5 KB
CLAUDE.mdmarkdown9 B
SKILL.mdskill md10.4 KB
evals/evals.jsonconfig7.6 KB
references/agile.mdmarkdown1.9 KB
references/attachments.mdmarkdown4.7 KB
references/comments.mdmarkdown14.4 KB
references/creation.mdmarkdown4.0 KB
references/fields-and-users.mdmarkdown7.7 KB
references/intent-verbs.mdmarkdown13.5 KB
references/issue-editing.mdmarkdown11.6 KB
references/jql-cookbook.mdmarkdown8.0 KB
references/jql-quick-reference.mdmarkdown6.3 KB
references/links.mdmarkdown7.8 KB
references/multi-profile.mdmarkdown3.9 KB
references/no-editorializing.mdmarkdown2.3 KB
references/qa-gather.mdmarkdown12.1 KB
references/troubleshooting.mdmarkdown12.0 KB
references/versions.mdmarkdown7.7 KB
references/watchers.mdmarkdown3.9 KB
references/worklog.mdmarkdown8.6 KB
scripts/core/jira-attachment.pyexecutablescript21.2 KB
scripts/core/jira-issue.pyexecutablescript50.6 KB
scripts/core/jira-search.pyexecutablescript9.6 KB
scripts/core/jira-setup.pyexecutablescript20.0 KB
scripts/core/jira-validate.pyexecutablescript14.2 KB
scripts/core/jira-worklog.pyexecutablescript15.5 KB
scripts/lib/__init__.pyscript742 B
scripts/lib/changelog.pyscript8.0 KB
scripts/lib/client.pyscript26.4 KB
scripts/lib/config.pyscript15.9 KB
scripts/lib/errors.pyscript1.8 KB
scripts/lib/input.pyscript3.5 KB
scripts/lib/jql.pyscript375 B
scripts/lib/markup.pyscript33.2 KB
scripts/lib/markup_cli.pyscript11.3 KB
scripts/lib/output.pyscript6.9 KB
scripts/lib/preview.pyscript10.0 KB
scripts/lib/render.pyscript1.8 KB
scripts/lib/ticket_state.pyscript13.3 KB
scripts/lib/users.pyscript7.5 KB
scripts/utility/jira-fields.pyexecutablescript11.7 KB
scripts/utility/jira-link.pyexecutablescript42.9 KB
scripts/utility/jira-qa-gather.pyexecutablescript26.3 KB
scripts/utility/jira-user.pyexecutablescript9.3 KB
scripts/utility/jira-watchers.pyexecutablescript9.1 KB
scripts/utility/jira-weblink.pyexecutablescript11.2 KB
scripts/utility/jira-worklog-query.pyexecutablescript27.4 KB
scripts/workflow/jira-board.pyexecutablescript7.0 KB
scripts/workflow/jira-comment.pyexecutablescript19.2 KB
scripts/workflow/jira-create.pyexecutablescript24.3 KB
scripts/workflow/jira-move.pyexecutablescript23.5 KB
scripts/workflow/jira-sprint.pyexecutablescript8.1 KB
scripts/workflow/jira-transition.pyexecutablescript33.7 KB
scripts/workflow/jira-version.pyexecutablescript29.4 KB
scripts/workflow/tempo-account.pyexecutablescript9.1 KB

scripts/workflow/jira-board.py

View on GitHub
#!/usr/bin/env -S uv run --script
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH
# /// script
# requires-python = ">=3.11"
# dependencies = [
#     "atlassian-python-api>=3.41.0,<4",
#     "click>=8.1.0,<9",
# ]
# ///
"""Jira board operations - list boards and get board issues."""

import sys
from pathlib import Path

# ═══════════════════════════════════════════════════════════════════════════════
# Shared library import (TR1.1.1 - PYTHONPATH approach)
# ═══════════════════════════════════════════════════════════════════════════════
_script_dir = Path(__file__).parent
_lib_path = _script_dir.parent / "lib"
if _lib_path.exists():
    sys.path.insert(0, str(_lib_path.parent))

import click
from lib.client import LazyJiraClient
from lib.output import error, format_output, format_table
from lib.users import person_label

# ═══════════════════════════════════════════════════════════════════════════════
# CLI Definition
# ═══════════════════════════════════════════════════════════════════════════════


@click.group()
@click.option("--json", "output_json", is_flag=True, help="Output as JSON")
@click.option("--quiet", "-q", is_flag=True, help="Minimal output")
@click.option("--env-file", type=click.Path(), help="Environment file path")
@click.option("--profile", "-P", help="Jira profile name from ~/.jira/profiles.json")
@click.option("--debug", is_flag=True, help="Show debug information on errors")
@click.pass_context
def cli(ctx, output_json: bool, quiet: bool, env_file: str | None, profile: str | None, debug: bool):
    """Jira board operations.

    List agile boards and get board issues.
    """
    ctx.ensure_object(dict)
    ctx.obj["json"] = output_json
    ctx.obj["quiet"] = quiet
    ctx.obj["debug"] = debug
    ctx.obj["client"] = LazyJiraClient(env_file=env_file, profile=profile)


@cli.command("list")
@click.option("--project", "-p", help="Filter by project key")
@click.option("--type", "-t", "board_type", type=click.Choice(["scrum", "kanban"]), help="Filter by board type")
@click.option("--name", "-n", "name_pattern", help="Filter by board name (server-side partial match)")
@click.pass_context
def list_boards(ctx, project: str | None, board_type: str | None, name_pattern: str | None):
    """List agile boards.

    Examples:

      jira-board list

      jira-board list --project PROJ

      jira-board list --type scrum

      jira-board list --name Lithium        # server-side partial match on board name
    """
    client = ctx.obj["client"]

    try:
        params = {}
        if project:
            params["projectKeyOrId"] = project
        if board_type:
            params["type"] = board_type
        if name_pattern:
            params["name"] = name_pattern

        boards: list[dict] = []
        start_at = 0
        while True:
            page_params = dict(params)
            page_params["startAt"] = start_at
            response = client.get("rest/agile/1.0/board", params=page_params) or {}
            values = response.get("values", []) or []
            boards.extend(values)
            is_last = bool(response.get("isLast"))
            if is_last or not values:
                break
            start_at += len(values)

        if ctx.obj["json"]:
            format_output(boards, as_json=True)
        elif ctx.obj["quiet"]:
            for b in boards:
                print(b.get("id", ""))
        else:
            if not boards:
                print("No boards found")
                if project:
                    print(f"  (filtered by project: {project})")
                if name_pattern:
                    print(f"  (filtered by name: {name_pattern})")
            else:
                print(f"Agile boards ({len(boards)} found):\n")
                rows = []
                for b in boards:
                    loc = b.get("location", {})
                    rows.append(
                        {
                            "ID": b.get("id", ""),
                            "Name": b.get("name", ""),
                            "Type": b.get("type", ""),
                            "Project": loc.get("projectKey", "-"),
                        }
                    )
                print(format_table(rows, ["ID", "Name", "Type", "Project"]))

    except Exception as e:
        if ctx.obj["debug"]:
            raise
        error(f"Failed to list boards: {e}")
        sys.exit(1)


@cli.command()
@click.argument("board_id", type=int)
@click.option("--jql", help="Additional JQL filter")
@click.option("--max-results", "-n", default=50, help="Maximum results")
@click.pass_context
def issues(ctx, board_id: int, jql: str | None, max_results: int):
    """Get issues on a board.

    BOARD_ID: The Jira agile board ID

    Examples:

      jira-board issues 42

      jira-board issues 42 --jql "status = 'In Progress'"

      jira-board issues 42 --max-results 20
    """
    client = ctx.obj["client"]

    try:
        params = {"maxResults": max_results}
        if jql:
            params["jql"] = jql

        response = client.get(f"rest/agile/1.0/board/{board_id}/issue", params=params)
        issues_list = response.get("issues", [])

        if ctx.obj["json"]:
            format_output(issues_list, as_json=True)
        elif ctx.obj["quiet"]:
            for issue in issues_list:
                print(issue["key"])
        else:
            if not issues_list:
                print(f"No issues on board {board_id}")
                if jql:
                    print(f"  (filtered by JQL: {jql})")
            else:
                print(f"Issues on board {board_id} ({len(issues_list)} shown):\n")
                rows = []
                for issue in issues_list:
                    fields = issue.get("fields", {})
                    status = fields.get("status", {}).get("name", "-")
                    assignee = fields.get("assignee", {})
                    assignee_name = person_label(assignee, fallback="-") if assignee else "-"
                    summary = fields.get("summary", "")
                    if len(summary) > 40:
                        summary = summary[:37] + "..."
                    rows.append({"Key": issue["key"], "Summary": summary, "Status": status, "Assignee": assignee_name})
                print(format_table(rows, ["Key", "Summary", "Status", "Assignee"]))

    except Exception as e:
        if ctx.obj["debug"]:
            raise
        error(f"Failed to get issues for board {board_id}: {e}")
        sys.exit(1)


if __name__ == "__main__":
    cli()
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall