Installable agent skill

/explain

把技術規格、agent 計畫、diff、進度、架構與多輪工作，轉成 PM 也能一次讀懂的理解介面。重點是定義概念、畫出結構、說清楚機制與邊界，避免自創術語與模糊代詞。

Quick install

適合你信任目前網頁來源、並允許本機 shell 寫入全域 skill 目錄時使用。

curl -fsSL https://explain-skill.pages.dev/install.sh | bash

Give this prompt to your agent

把這段和本頁網址一起丟給 agent。agent 可以選擇下載 zip 或直接讀取下面列出的檔案。

Please install the `explain` skill from this page.

Source page: https://explain-skill.pages.dev
Package: https://explain-skill.pages.dev/explain-skill.zip

Create a local skill named `explain`.

Install targets:
- Claude Code: `~/.claude/skills/explain`
- Codex: `~/.agents/skills/explain`

Use the package contents exactly:
- `SKILL.md`
- `agents/openai.yaml`
- `examples/progress-change-comprehension.md`

If an `explain` skill already exists, back it up before replacing it.
Do not modify unrelated skills.
After installation, ask me to restart any running Claude Code or Codex sessions so the skill list refreshes.

Mechanism

1. ReadAgent reads this page or package.

2. CreateAgent creates a local `explain` skill folder.

3. InstallFiles are copied into Claude Code and/or Codex skill roots.

4. RestartNew agent sessions can invoke `/explain`.

Manual install

不想跑 shell installer 時，可以讓 agent 照這個做。

mkdir -p ~/.claude/skills ~/.agents/skills
curl -fsSL https://explain-skill.pages.dev/explain-skill.zip -o /tmp/explain-skill.zip
rm -rf /tmp/explain-skill
mkdir -p /tmp/explain-skill
unzip -q /tmp/explain-skill.zip -d /tmp/explain-skill
cp -R /tmp/explain-skill/explain ~/.claude/skills/explain
cp -R /tmp/explain-skill/explain ~/.agents/skills/explain

Files included

explain/SKILL.md Open

explain/agents/openai.yaml Open

explain/examples/progress-change-comprehension.md Open

explain-skill.zip Download

What this skill changes

要求 agent 先說明「這是什麼」，再使用任何專案術語或縮寫。
非簡單說明要包含 `What this is`、`Why it matters`、`Concept model`、`Mechanism`、`Boundaries / not included`。
技術或 spec 說明要優先使用 UML-style concept map、sequence diagram、decision table 或其他可視化結構。
明確禁止自創縮寫、炫技比喻、模糊代詞與未定義 jargon。

Boundaries

這不是 code review skill。它不會預設批判、審核或挑戰方案。它的用途是讓 agent 把技術內容、規格、計畫、進度或改動說清楚。

已開啟的 agent session 可能不會立刻看到新 skill。安裝後請新開或重啟 Claude Code / Codex session。