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

references/multi-profile.md

View on GitHub
<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
<!-- SPDX-FileCopyrightText: Netresearch DTT GmbH -->

# Multi-Profile Configuration

## When to load

Load this reference whenever the user mentions more than one Jira instance, asks about `--profile`, `.jira-profile`, or `~/.jira/profiles.json`, or when auto-resolution by URL/issue-key prefix is unclear.

Manage connections to multiple Jira instances via `~/.jira/profiles.json`.

## Profile Resolution Priority

When a script runs, it resolves which profile to use in this order:

1. **Explicit `--profile` flag** — `--profile myprofile` selects the named profile directly
2. **Full Jira URL** — matches the URL's host against each profile's `url` field (normalized, port-insensitive)
3. **Issue key prefix** — matches the project prefix (e.g. `WEB` from `WEB-1381`) against each profile's `projects` list
4. **`.jira-profile` file** — reads the profile name from a `.jira-profile` file in the current working directory
5. **Default profile** — uses the `default` key from `profiles.json`

If none of the above match, the script raises an error listing available profiles.

## `--profile` Flag

All scripts accept `--profile` (or `-P`) to select a profile explicitly:

```bash
uv run ${CLAUDE_SKILL_DIR}/scripts/core/jira-issue.py --profile cloud get WEB-123
uv run ${CLAUDE_SKILL_DIR}/scripts/core/jira-search.py --profile server query "project = OPS"
```

## `~/.jira/profiles.json` Format

```json
{
  "default": "cloud",
  "profiles": {
    "cloud": {
      "url": "https://yourcompany.atlassian.net",
      "auth": "cloud",
      "username": "user@example.com",
      "api_token": "your-cloud-api-token",
      "projects": ["WEB", "MOBILE", "API"]
    },
    "server": {
      "url": "https://jira.yourcompany.com",
      "auth": "pat",
      "token": "your-personal-access-token",
      "projects": ["OPS", "INFRA", "SRVMO"]
    }
  }
}
```

### Fields

| Field | Required | Description |
|-------|----------|-------------|
| `url` | Always | Jira instance URL |
| `auth` | No | `"cloud"` or `"pat"` (default: `"pat"`) |
| `token` | If `auth: "pat"` | Personal access token (Server/DC) |
| `username` | If `auth: "cloud"` | Atlassian account email |
| `api_token` | If `auth: "cloud"` | Atlassian API token |
| `cloud` | No | `true` or `false`; sets the deployment type, like `JIRA_CLOUD`. Needed for a Cloud site whose `url` is not `*.atlassian.net` (a reverse proxy or a custom domain). Without it, the type comes from the URL |
| `projects` | No | List of project prefixes for auto-resolution from issue keys |

### Top-Level Keys

| Key | Description |
|-----|-------------|
| `default` | Name of the default profile (used as fallback) |
| `profiles` | Object mapping profile names to their configuration |

## `.jira-profile` File

Place a `.jira-profile` file in a project directory to set the default profile for that project:

```bash
echo "server" > /path/to/my-project/.jira-profile
```

When you run a script from that directory without `--profile` and without an issue key match, the profile named in `.jira-profile` is used.

## Auto-Resolution from Issue Key

When you reference an issue like `WEB-123`, the script extracts the project prefix `WEB` and checks each profile's `projects` list. If exactly one profile lists `WEB`, that profile is selected automatically.

If multiple profiles claim the same project prefix, the script raises an error asking you to disambiguate with `--profile`.

## Migration and Management

- **`--migrate`**: Use `jira-setup.py --migrate` to convert an existing `~/.env.jira` file into a profile in `~/.jira/profiles.json`.
- **`--all-profiles`**: Use `jira-validate.py --all-profiles` to validate all configured profiles at once.

## Fallback Behavior

If `~/.jira/profiles.json` does not exist, scripts fall back to the legacy `~/.env.jira` file and environment variables. The `--profile` flag requires `profiles.json` to exist.
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 CodeCodexUnverifiedInstall
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