How do I install the Jira Twg skill?

Run npx skillmds@latest add edmundmiller/jira-twg in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Jira Twg safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Jira Twg?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Jira Twg free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Jira Twg?

edmundmiller (@edmundmiller) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Jira Twg by edmundmiller — Agent Skill

Name: Jira Twg
Author: edmundmiller

File contents

Jira via TWG

Requires the twg and jg CLIs. Use twg only for Jira work. Do not install, update, authenticate, or repair it unless the user asks.

Read narrowly

Choose one leaf command:

Known keys, maximum 20 per batch: twg jira workitem get KEY [KEY...] --fields summary,status,assignee
Exact criteria: twg jira workitem query --jql '...' --limit 20
Fuzzy text: twg jira workitem search '...' --limit 10 --fields summary,status,assignee

Request only fields needed for the answer and batch known keys. Never use --full, --comments, or --remote-links unless that content is required. Never enumerate projects when an issue key or project is already known.

Append --output json --output-summary auto --agent-fields @compact. For query or search lists, use @rows only when key, summary, status, URL, and updated are sufficient; otherwise set explicit data.issues.<field> paths. Reserve --output-summary stats for output expected to exceed the bounded limits above. Use --select only when response paths are already known.

Use stdout_inline when present. Otherwise read output_files.compact; read only required paths from output_files.stdout when the compact file lacks a needed field.

Enforce the budget

Never repeat an identical command. Reuse saved output; allow one bounded shape inspection and one extraction, then stop.
For read-only work, allow at most three Jira commands total and at most two reads of one issue. If that cannot answer the request, report the missing fact or ask before widening scope.
Do not browse help first. After a rejected or genuinely unknown command, allow one twg help describe "<exact leaf command>" | jg 'args | opts' --compact; never list or search the full command catalog.
Preserve stderr and exit status. Distinguish empty data from failure; never use 2>/dev/null or translate an error into “no results.”
Stop immediately on authentication or permission failure. After a contract error, use the one help allowance, make one corrected attempt, then stop and report the error.

Write once

For an exact user-authorized mutation, read the write contracts before acting. They define current command shapes, the four-command ceiling, verification, and ambiguous-create handling. Do not improvise write flags.

Maintain the contract

After a TWG upgrade, run python3 ~/.agents/skills/jira-twg/scripts/check_contract.py --json. It reads local help only and makes no Jira request. Do not run it during ordinary Jira work.

---name: jira-twgdescription: Use the TWG CLI for explicit Jira issue reads, searches, queries, and mutations while minimizing returned context and preventing refetch or help loops. Do not use for Confluence, general Atlassian context, or TWG setup.---# Jira via TWGRequires the `twg` and `jg` CLIs. Use `twg` only for Jira work. Do not install, update, authenticate, or repair it unless the user asks.## Read narrowlyChoose one leaf command:- Known keys, maximum 20 per batch: `twg jira workitem get KEY [KEY...] --fields summary,status,assignee`- Exact criteria: `twg jira workitem query --jql '...' --limit 20`- Fuzzy text: `twg jira workitem search '...' --limit 10 --fields summary,status,assignee`Request only fields needed for the answer and batch known keys. Never use `--full`, `--comments`, or `--remote-links` unless that content is required. Never enumerate projects when an issue key or project is already known.Append `--output json --output-summary auto --agent-fields @compact`. For query or search lists, use `@rows` only when key, summary, status, URL, and updated are sufficient; otherwise set explicit `data.issues.<field>` paths. Reserve `--output-summary stats` for output expected to exceed the bounded limits above. Use `--select` only when response paths are already known.Use `stdout_inline` when present. Otherwise read `output_files.compact`; read only required paths from `output_files.stdout` when the compact file lacks a needed field.## Enforce the budget- Never repeat an identical command. Reuse saved output; allow one bounded shape inspection and one extraction, then stop.- For read-only work, allow at most three Jira commands total and at most two reads of one issue. If that cannot answer the request, report the missing fact or ask before widening scope.- Do not browse help first. After a rejected or genuinely unknown command, allow one `twg help describe "<exact leaf command>" | jg 'args | opts' --compact`; never list or search the full command catalog.- Preserve stderr and exit status. Distinguish empty data from failure; never use `2>/dev/null` or translate an error into “no results.”- Stop immediately on authentication or permission failure. After a contract error, use the one help allowance, make one corrected attempt, then stop and report the error.## Write onceFor an exact user-authorized mutation, read [the write contracts](./references/writes.md) before acting. They define current command shapes, the four-command ceiling, verification, and ambiguous-create handling. Do not improvise write flags.## Maintain the contractAfter a TWG upgrade, run `python3 ~/.agents/skills/jira-twg/scripts/check_contract.py --json`. It reads local help only and makes no Jira request. Do not run it during ordinary Jira work.

Frequently asked questions

Jira Twg