TWG CLI ships installable skills that teach AI agents how to discover and use commands. Skills follow the .agents/skills/ convention supported by multiple coding agents.

Install Skills

1
2
# Install into current project (.agents/skills/twg)
twg skills install

# Install globally for all projects (~/.agents/skills/twg)
twg skills install --global

Supported Agents

Skills are auto-discovered by:

Rovo Dev (Atlassian)
Claude Code (Anthropic)
Cursor
OpenAI Codex
Amp
Any agent that supports .agents/skills/ directories

What Skills Include

Each skill installation contains:

File	Purpose
`SKILL.md`	Routing guidance, workflow, write confirmation rules
`scripts/twg`	Wrapper script that resolves the `twg` binary
`references/COMMANDS.md`	Compact command index with key flags
`references/ROUTING.md`	Surface selection decision tree
`references/GLOBAL-CONTRACT.md`	Shared patterns, filters, pagination

Agent Mode

When agents call TWG CLI, they should append --mode agent:

1
2
twg work query --scope me --since 7d --mode agent

This produces quieter output, strips hints and warnings from response envelopes, and pairs with --output-file <path> for large results.

Packaging for Distribution

1
2
# Package as a zip (e.g. for Claude Cowork plugin)
twg skills package --target cowork