{"id":16549,"plugin_id":"plugins_6a594972bcd881918932439854a2fc5a","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:13:30.738Z","digest":"97b8c1d69b1be4eb1dfd980c9bba4bfd62c4f8f39d404add36781ca506f5f953","against":null,"payload":{"description":"Install, upgrade, authenticate, or repair `twg` for Codex, including missing CLI or skills and doctor/auth follow-up. TWG gives Codex grounded work context across Jira, Confluence, Bitbucket, JSM, Assets, Slack, Google Drive, and more, so it can connect tickets, docs, code, people, and decisions; surface risks and dependencies; summarize progress; and keep work moving.","included_files":[],"name":"twg-setup","skill_md_contents":"---\nname: twg-setup\ndescription: Install, upgrade, authenticate, or repair `twg` for Codex, including missing CLI or skills and doctor/auth follow-up. TWG gives Codex grounded work context across Jira, Confluence, Bitbucket, JSM, Assets, Slack, Google Drive, and more, so it can connect tickets, docs, code, people, and decisions; surface risks and dependencies; summarize progress; and keep work moving.\nallowed-tools: Bash\n---\n\n# TWG Setup\n\nRecognized installer hosts: `claude-code`, `codex`, `copilot`, `cursor`, `devin`, `gemini`, `hermes`, `intellij`, `opencode`, `pi`, `qoder`, `vscode`.\n\n## Unix / macOS\n\n**Installer command — run in your terminal**\n\n```bash\ncurl -fsSL --retry 2 https://teamwork-graph.atlassian.com/cli/install | bash -s -- --plugin codex\n```\n\n**Inspect**\n\n```bash\nTWG_BIN=\"$(command -v twg || true)\"\nif [ -z \"$TWG_BIN\" ] && [ -x \"$HOME/.local/bin/twg\" ]; then\n  TWG_BIN=\"$HOME/.local/bin/twg\"\nfi\nif [ -z \"$TWG_BIN\" ]; then\n  echo \"twg was not found at the standard launcher path; install TWG or add its directory to PATH.\" >&2\nfi\n[ -n \"$TWG_BIN\" ] && \"$TWG_BIN\" doctor || true\n```\n\n## Windows PowerShell\n\n**Installer command — run in PowerShell**\n\n```powershell\ncurl.exe -fsSL https://teamwork-graph.atlassian.com/cli/install.ps1 -o \"$env:TEMP\\twg-install.ps1\"\npowershell -ExecutionPolicy Bypass -File \"$env:TEMP\\twg-install.ps1\" -Plugin codex\n```\n\n**Inspect**\n\n```powershell\n$twgCommand = Get-Command twg -ErrorAction SilentlyContinue\n$TWG_BIN = if ($twgCommand) { $twgCommand.Path } else { $null }\nif (-not $TWG_BIN -and $env:LOCALAPPDATA) {\n  $fallback = Join-Path $env:LOCALAPPDATA \"Programs\\twg\\bin\\twg.exe\"\n  if (Test-Path -LiteralPath $fallback -PathType Leaf) { $TWG_BIN = $fallback }\n}\nif (-not $TWG_BIN) {\n  Write-Warning \"twg was not found; use the installer command above.\"\n}\nif ($TWG_BIN) {\n  & $TWG_BIN doctor\n}\n```\n\n## Common flow\n\nInfer the current host from runtime context; never ask the user to identify it. Use its\nplugin argument when recognized; omit it only when the host is genuinely unknown. Do not\nnarrate the plugin argument or describe attribution or analytics to the user.\n\n1. Run the OS-specific **Inspect** block.\n2. If the CLI is missing, give the user the OS-specific installer command with the plugin\n   argument for a recognized host. Do not execute it, even in an interactive terminal. End with\n   `When it finishes, reply done.` Do not include `doctor` or another follow-up command.\n3. After the user replies `done`, run the OS-specific **Inspect** block yourself so `doctor`\n   verifies the installation. Never ask the user to run `doctor` or paste its output, and never\n   reinstall for auth, permission, or command errors.\n\nPut every installer or remediation command handed to the user in a fenced `bash` or `powershell`\nblock. Use raw URLs; never render a command inline or as a Markdown link. The user completes\nagreements, browser authentication, optional connections, and secret entry in their own terminal.\nNever request or expose tokens, passwords, API keys, 2FA/OTP codes, or OAuth `device_code`.\n\n## Doctor remediation\n\nUse this section only for a pre-existing install or after the user replies `done`. Run only the\nreported fix.\n\n- Give interactive auth and setup fixes to the user; never execute them yourself. Put the command\n  in the matching fenced block, end with `When it finishes, reply done.`, and rerun `doctor`\n  yourself after that reply.\n- Run noninteractive fixes, including skill refresh, directly, then rerun `doctor`.\n- OAuth: `twg login --force`.\n- Initial/general setup: `twg setup`.\n- Optional Bitbucket: `twg setup bitbucket`.\n\n### Skill refresh\n\nIf doctor reports a skill issue or Codex cannot see TWG skills, refresh them at\n`~/.agents/skills`:\n\n```text\ntwg skills install --yes\n```\n\nAfter a skill install or refresh, start a new Codex thread.\n\nSummarize any remaining issue in one line.\n\n## Continue The Original Request\n\nWhen `doctor` is healthy, resume and complete the user's original request. Do not stop\nat setup or ask the user to choose a new task.\n\n## Things To Try\n\nOnly when the user's request was setup alone, offer a few useful TWG prompts:\n\n- Use `twg work query` and `twg collaborators` to brief me on my last 7 days: top three workstreams, key people involved, blockers, and next actions.\n- I was out for [N days]. Catch me up on [topic]: material changes, decisions, blockers, conversations I should respond to, and my top three next actions.\n- Who should I talk to about [topic]? Identify the owner and up to three experts, explain why each is relevant, and tell me whom to contact first.\n- What's the latest status of [project]? Include the owner, last update, blockers or risks, and next milestone.\n- Find the three most useful current design docs or PRDs for [topic]. Explain what each establishes and flag stale or conflicting guidance.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}