Copyable deliverable
This skill should be used whenever a maigo command produces a deliverable destined to be pasted elsewhere (a PR/issue comment, a reply draft, a commit message, a gh command draft). It mandates wrapping that content in a single fenced code block so the user gets raw, one-click-copyable markdown instead of a rendered-only version.From its SKILL.md
npx -y skills add Lee-W/maigo --skill copyable-deliverableAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.1 KB, as published. Nobody here has run it
Copyable Deliverable
Owner Agent: orchestrator(呈現 deliverable 給使用者時)
Consumers:
/maigo:review、
/maigo:triage-issue、
/maigo:describe-pr、
skills/github-title-description、
skills/commit-message
When to apply
Deliverable = 使用者會拿去貼到別處的內容:PR comment / issue reply 草稿、
commit message 草稿、gh 指令草稿、PR title / description。
不適用:純對話 / 分析 / 背景說明、review verdict 的 judgement 段落 (checklist / evidence)、純狀態 / queue 表——除非使用者明確要求弄成可複製。
The rule
Deliverable 一律放進單一 fenced code block,內含 raw markdown。
- 外層 fence 用四個 backtick(
````)——deliverable 內部若有三-backtick code block(例:Test Plan 的指令)才不會把外層截斷。 - 整份 deliverable 在同一個 block 裡,不要拆成多塊。
- block 外可以有說明文字(「可整段複製貼到 GitHub:」),但 deliverable 本身要在 block 內。
範例:
可整段複製貼到 GitHub PR comment:
````markdown
幾個問題想確認:
1. `auth.py:42` 的 early return 在 `token == None` 時會跳過 audit log,是預期行為嗎?
整體設計方向 OK,等回覆再 approve。
````
Why
平台 render markdown 後,使用者從 UI 框選複製到的是 rendered 結果,不是 raw 語法—— 手動框選費工又容易在內部 code block 處截斷。一個 fenced block = 一鍵複製 = 零選取誤差。
Prose 不 hard-wrap
Deliverable 內的 prose 段落一行連續到底,不手動斷行——表格列、list item、 fenced code block 內容不受影響(本來就一行一項 / 逐字保留)。
理由同上:hard-wrap 的段落,使用者每次改字都要重排、diff 也雜;一段一行才好 複製、好編輯、diff 乾淨。
What this skill does NOT cover
- 純對話 / 分析 / 狀態表——那是 orchestrator 的敘述,不是 deliverable
- 自動化路徑——
commit-message的 output 若直接 pipe 進git commit -F -,不加外層 fence (fence 會破壞 pipe);呈現給使用者過目時才適用本 skill。這個 pipe vs 呈現的區分已在commit-message內部說明。