From a55bfe0f28eec8c58c4280a0e28884f5d931ce6c Mon Sep 17 00:00:00 2001
From: "ci[bot]" <ci-bot@local>
Date: Wed, 1 Apr 2026 02:13:48 +0000
Subject: [PATCH] :package: deps(skills): sync superpowers

---
 codex/skills/ui-ux-pro-max/SOURCE.md          |  2 +-
 codex/skills/ui-ux-pro-max/scripts/core.py    |  0
 codex/skills/using-superpowers/SKILL.md       |  4 +-
 .../references/copilot-tools.md               | 52 +++++++++++++++++++
 4 files changed, 56 insertions(+), 2 deletions(-)
 mode change 100644 => 100755 codex/skills/ui-ux-pro-max/scripts/core.py
 create mode 100644 codex/skills/using-superpowers/references/copilot-tools.md

diff --git a/codex/skills/ui-ux-pro-max/SOURCE.md b/codex/skills/ui-ux-pro-max/SOURCE.md
index 894dfc8..f929037 100644
--- a/codex/skills/ui-ux-pro-max/SOURCE.md
+++ b/codex/skills/ui-ux-pro-max/SOURCE.md
@@ -2,5 +2,5 @@
 
 - Repo: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
 - Ref: 4255c218a6762c945a782701fd38dfb24fc10064
-- Snapshot: 2026-03-31
+- Snapshot: 2026-04-01
 - Notes: generated from upstream Codex template for playbook self-contained skill packaging
diff --git a/codex/skills/ui-ux-pro-max/scripts/core.py b/codex/skills/ui-ux-pro-max/scripts/core.py
old mode 100644
new mode 100755
diff --git a/codex/skills/using-superpowers/SKILL.md b/codex/skills/using-superpowers/SKILL.md
index d813535..c8a8570 100644
--- a/codex/skills/using-superpowers/SKILL.md
+++ b/codex/skills/using-superpowers/SKILL.md
@@ -29,13 +29,15 @@ If CLAUDE.md, GEMINI.md, or AGENTS.md says "don't use TDD" and a skill says "alw
 
 **In Claude Code:** Use the `Skill` tool. When you invoke a skill, its content is loaded and presented to you—follow it directly. Never use the Read tool on skill files.
 
+**In Copilot CLI:** Use the `skill` tool. Skills are auto-discovered from installed plugins. The `skill` tool works the same as Claude Code's `Skill` tool.
+
 **In Gemini CLI:** Skills activate via the `activate_skill` tool. Gemini loads skill metadata at session start and activates the full content on demand.
 
 **In other environments:** Check your platform's documentation for how skills are loaded.
 
 ## Platform Adaptation
 
-Skills use Claude Code tool names. Non-CC platforms: see `references/codex-tools.md` (Codex) for tool equivalents. Gemini CLI users get the tool mapping loaded automatically via GEMINI.md.
+Skills use Claude Code tool names. Non-CC platforms: see `references/copilot-tools.md` (Copilot CLI), `references/codex-tools.md` (Codex) for tool equivalents. Gemini CLI users get the tool mapping loaded automatically via GEMINI.md.
 
 # Using Skills
 
diff --git a/codex/skills/using-superpowers/references/copilot-tools.md b/codex/skills/using-superpowers/references/copilot-tools.md
new file mode 100644
index 0000000..4316cdb
--- /dev/null
+++ b/codex/skills/using-superpowers/references/copilot-tools.md
@@ -0,0 +1,52 @@
+# Copilot CLI Tool Mapping
+
+Skills use Claude Code tool names. When you encounter these in a skill, use your platform equivalent:
+
+| Skill references | Copilot CLI equivalent |
+|-----------------|----------------------|
+| `Read` (file reading) | `view` |
+| `Write` (file creation) | `create` |
+| `Edit` (file editing) | `edit` |
+| `Bash` (run commands) | `bash` |
+| `Grep` (search file content) | `grep` |
+| `Glob` (search files by name) | `glob` |
+| `Skill` tool (invoke a skill) | `skill` |
+| `WebFetch` | `web_fetch` |
+| `Task` tool (dispatch subagent) | `task` (see [Agent types](#agent-types)) |
+| Multiple `Task` calls (parallel) | Multiple `task` calls |
+| Task status/output | `read_agent`, `list_agents` |
+| `TodoWrite` (task tracking) | `sql` with built-in `todos` table |
+| `WebSearch` | No equivalent — use `web_fetch` with a search engine URL |
+| `EnterPlanMode` / `ExitPlanMode` | No equivalent — stay in the main session |
+
+## Agent types
+
+Copilot CLI's `task` tool accepts an `agent_type` parameter:
+
+| Claude Code agent | Copilot CLI equivalent |
+|-------------------|----------------------|
+| `general-purpose` | `"general-purpose"` |
+| `Explore` | `"explore"` |
+| Named plugin agents (e.g. `superpowers:code-reviewer`) | Discovered automatically from installed plugins |
+
+## Async shell sessions
+
+Copilot CLI supports persistent async shell sessions, which have no direct Claude Code equivalent:
+
+| Tool | Purpose |
+|------|---------|
+| `bash` with `async: true` | Start a long-running command in the background |
+| `write_bash` | Send input to a running async session |
+| `read_bash` | Read output from an async session |
+| `stop_bash` | Terminate an async session |
+| `list_bash` | List all active shell sessions |
+
+## Additional Copilot CLI tools
+
+| Tool | Purpose |
+|------|---------|
+| `store_memory` | Persist facts about the codebase for future sessions |
+| `report_intent` | Update the UI status line with current intent |
+| `sql` | Query the session's SQLite database (todos, metadata) |
+| `fetch_copilot_cli_documentation` | Look up Copilot CLI documentation |
+| GitHub MCP tools (`github-mcp-server-*`) | Native GitHub API access (issues, PRs, code search) |