Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Apr 1, 2026

Agent skills

TWG CLI ships installable skills — context files that teach your coding agent how to work with Atlassian products. Install them once, then just describe what you want in plain language.

Install skills

After installing and authenticating, run:

1
2
twg skills install

The installer shows an interactive picker. Choose your agent and it handles the rest.

Claude

Claude Code stores skills in .claude/skills/. Select it in the installer and the TWG skill is placed there automatically. After that, open Claude Code in your project and start asking:

"What are my open Jira issues?" "Summarize the work my team did this week." "Create a Confluence page summarizing our Q2 goals."

Codex

OpenAI Codex reads skills from the universal .agents/skills/ directory, which is always included in the install. No extra step needed — select Codex in the picker and you're done. Then ask Codex:

"Show me the current sprint and any blockers." "Find PRs I authored this month." "What goals are at risk for my team?"

Gemini

Gemini CLI also reads from .agents/skills/ automatically. Select it in the picker. Then:

"Who do I collaborate with most?" "Get full context on PROJ-123 — linked PRs, docs, and dependencies." "Show my reporting chain."

Other agents

The installer also supports Cursor, GitHub Copilot, Rovo Dev, Augment, Kiro CLI, OpenCode, and any agent that supports a skills or context directory. The universal .agents/skills/ location works out of the box for most agents.

What gets installed

Skills are placed under .agents/skills/ (and any agent-specific locations you select) as a set of sibling skill directories — one per surface or recipe. Each skill directory contains its own SKILL.md and (where relevant) scripts/ and references/.

LayoutPurpose
.agents/skills/twg/SKILL.mdUmbrella router and shared planner contract
.agents/skills/twg-<surface>/SKILL.mdPer-product surface skills (e.g. twg-jira, twg-confluence, twg-bitbucket)
.agents/skills/twg-<recipe>/SKILL.mdWorkflow recipes (e.g. twg-workitem-context, twg-personal-update, twg-graph-visualization)
.agents/skills/<skill>/scripts/Optional helper scripts bundled with a skill. Prefer first-class CLI commands for deterministic generation flows; for example internal graph rendering is handled by twg visualize, while the graph skill documents JSON shape and best practices
.agents/skills/<skill>/references/Reference docs loaded on demand (CQL/JQL/AQL recipes, schemas, etc.)

Your agent reads these automatically. No special prompt prefix is needed.

Next steps

Rate this page: