一個 單一 repo 的 Claude Code plugin marketplace， 把我常用的 skill 收成可安裝的 plugin，讓它們在任何一台電腦上都能用（跨機、可版本控管、可更新）。
- 一個 marketplace：
how-skills - 四個 plugin：
skill-tools、ponytail、media-tools、taiwan-biz-research
Claude Code 的個人 skill 放在 ~/.claude/skills/，但那是本機的、不會跟帳號同步。
要在多台電腦共用，官方做法就是包成 plugin 放進一個 git-hosted marketplace，
每台機器 add 一次、install 想要的 plugin 即可，日後更新只要 git push + marketplace update。
命名空間：裝成 plugin 後，指令會加上 plugin 名前綴。 例如
skill-list→/skill-tools:skill-list、ponytail-review→/ponytail:ponytail-review。
在每一台要使用的電腦上：
# 1) 加入這個 marketplace（一次即可）
/plugin marketplace add hsnuhow/how-skills
# 2) 安裝想要的 plugin
/plugin install skill-tools@how-skills
/plugin install ponytail@how-skills
/plugin install media-tools@how-skills
/plugin install taiwan-biz-research@how-skills安裝後開一個新的 session 指令才會載入。
驗證是否裝好：
/plugin # 互動式查看已裝 plugin
claude plugin list # CLI 列出| 指令 | 用途 | 範例 |
|---|---|---|
/skill-tools:skill-list |
列出所有可用 skill，附中文用途（要點式、跨專案格式一致） | 想快速看「我有哪些 skill」 |
/skill-tools:skill-status |
分清 skill 來自系統／專案／plugin 哪一層，並標記同名衝突 | 想知道某個 skill 是哪來的 |
/skill-tools:skill-RCM |
依專案記憶＋CLAUDE.md＋產品文件＋技術棧，建議該裝哪些 skill | 進到新專案想知道「該補什麼工具」 |
三者皆唯讀、絕不寫入記憶。
| 指令 | 用途 |
|---|---|
/ponytail:ponytail [lite|full|ultra] |
開啟「懶惰資深工程師」精簡模式（明確呼叫才啟動） |
/ponytail:ponytail-review |
針對 diff 只審過度設計、列出可刪項 |
/ponytail:ponytail-audit |
掃整個 repo 的過度設計 |
/ponytail:ponytail-debt |
收集程式碼中的 ponytail: 註解成技術債清單 |
/ponytail:ponytail-gain |
顯示 ponytail 的效益計分板 |
/ponytail:ponytail-help |
指令與模式速查 |
本 build 不含任何 hooks，預設完全不自動啟動（見設計原則）。
| 指令 | 用途 |
|---|---|
/media-tools:video-to-gif |
影片（或指定時間區段）轉動畫 GIF（ffmpeg） |
/media-tools:pptx-to-pdf |
簡報轉高保真 PDF、字型內嵌（LibreOffice） |
/media-tools:compress-pdf |
壓縮 PDF 到可 email 的大小（Ghostscript） |
三層架構，從資料到建議：
| Skill | 用途 |
|---|---|
tw-data |
台灣經濟資料層：景氣燈號（1984-）、家庭收支（1976-）、上市月營收、外銷訂單、總經、營業稅行業別銷售額（含中小企業）——全部免費免 key 政府開放資料，政府端點的坑（ROC 年、破損憑證、200-非資料、靜默回退）都包掉了 |
strategy-frameworks |
決策導向框架路由：什麼問題用什麼框架、用哪個資料指令餵它、以及哪些框架在台灣的免費資料下根本做不出來（做不出來本身就是發現） |
biz-case-workflow |
多 agent 端到端工作流：界定決策 → 抓數 → 交叉驗證 → 三視角對抗性駁斥 → 合成建議。約 15-25 隻 agent，給需要「經得起攻擊」而非「聽起來合理」的結論用 |
場外來源（DMA 廣告量、Reuters DNR 付費率、TAICCA 產值）已驗證取法並快照於
tw-data/references/external-sources.md。純 Python 標準庫，無額外依賴。
改 skill 就三步：
# 1) 編輯 SKILL.md
$EDITOR plugins/skill-tools/skills/skill-list/SKILL.md
# 2) 提交並推上 GitHub
git add -A && git commit -m "改了什麼" && git push
# 3) 各機器更新
/plugin marketplace update how-skills版本控制：plugin.json 有寫 version 時，使用者只有在你改版號後才會收到更新；
若拿掉 version，git 每個 commit 都算新版本。本 repo 目前有寫 version，發佈新版記得 bump。
開發機小抄：這台開發機的 marketplace 直接指向本機這個 repo 資料夾，
所以 marketplace update 會抓到你剛編輯的內容，不必先 push 也能本機測。
（其他電腦則是從 GitHub 抓。）
how-skills/
├── .claude-plugin/
│ └── marketplace.json # marketplace 目錄，列出所有 plugin
├── plugins/
│ ├── skill-tools/
│ │ ├── .claude-plugin/plugin.json
│ │ ├── README.md
│ │ └── skills/
│ │ ├── skill-list/SKILL.md
│ │ ├── skill-status/SKILL.md
│ │ └── skill-RCM/SKILL.md
│ └── ponytail/
│ ├── .claude-plugin/plugin.json
│ ├── README.md
│ ├── NOTICE.md # 對上游 ponytail 的致謝與改動說明
│ └── skills/
│ ├── ponytail/SKILL.md
│ ├── ponytail-audit/SKILL.md
│ ├── ponytail-debt/SKILL.md
│ ├── ponytail-gain/SKILL.md
│ ├── ponytail-help/SKILL.md
│ └── ponytail-review/SKILL.md
├── README.md
└── LICENSE
格式要點（照 Claude Code plugin 規範）：
marketplace.json頂層需要name、owner、plugins[]；每個 plugin 用source: "./plugins/<名稱>"（相對路徑，必須./開頭，相對 repo 根）。plugin.json只有name必填。- 一個 plugin 的 skill 放在該 plugin 的
skills/<名稱>/SKILL.md。 - 驗證：
claude plugin validate ./plugins/<名稱> --strict。
- 不自動啟動：skill-tools 三個指令綁明確觸發、
ponytail主 skill 改成 explicit-invoke， 且 ponytail 不帶 hooks——平常都不會自動上身，只有你叫它才動。 - 不污染記憶：skill-tools 系列只讀不寫記憶，避免在專案記憶累積無關雜訊。
- 要點式輸出：
skill-list固定精簡、跨專案一致。
- 本 repo 以 MIT 授權（見 LICENSE）。
plugins/ponytail衍生自 DietrichGebert/ponytail（MIT）。 本 build 移除其全部 hooks 並將主 skill 改為 explicit-invoke； 詳細改動與致謝見 plugins/ponytail/NOTICE.md。
User-scope installs do not sync to cloud sessions — the cloud VM clones the
repo fresh and only reads the repo's own .claude/settings.json. To make these
plugins available in any repo's cloud/cowork sessions, commit this to that
repo's .claude/settings.json:
{
"extraKnownMarketplaces": {
"how-skills": {
"source": { "source": "github", "repo": "hsnuhow/how-skills" }
}
},
"enabledPlugins": {
"taiwan-biz-research@how-skills": true
}
}The session installs the plugin from GitHub at startup (needs network access). This repo carries the same file, so cloud sessions opened on it get the plugin automatically.