懶人包
- instagram-agent-skill 是 Jake Schincariol 在 2026-09-13 開源的 Claude Skill 包(MIT),13 個 IG 經營指令加 5 支本機 Python 工具,查詢當天 3,778 星、814 forks。它只產出文字,不幫你發文。
- 英文樣本跑起來跟 README 一致:hookscore 把「Hey guys」打成 9.6 分 WEAK,humanize 換掉 8 個套話詞。
- 中文樣本幾乎全部失效:137 字的中文腳本被 beats.py 算成 8 個字、2.9 秒,humanize 對中文套話抓到 0 個。原因是工具用只認 ASCII 的 regex 切字。
- 在 Windows 繁中系統(cp950)直接跑,碰到 emoji 會丟 UnicodeEncodeError,要加
python -X utf8。- 我寫了 123 行的中文補丁 zh_ig.py,估時修到 30.4 秒並抓出開場 4.4 秒太長,套話清理抓到 10 處;hookscore、detect、caption 三支還沒補。
- 作者自己公開 hook 評分的實測:抓爛開場 AUC 0.83,從同一個創作者的作品裡挑贏家只有 0.56,跟擲硬幣差不多。
IG 帳號 @hsing.daily 在 2026-10-29 發了一支 Reel,標題是「Claude Code 把 IG 幹掉了」,說一套免費 Skill 能從找題材、寫腳本、分析爆款一路做到規劃整週內容。貼文要你留言「Reel」拿完整教學,我抓資料時是 320 個讚、1,694 則留言。
我沒有去留言,直接到 GitHub 把 repo clone 下來,用中英文兩組樣本把 5 支 Python 工具都跑了一遍。結論是:英文能用,中文工具幾乎全失效,13 份 SKILL.md 提示詞本身則不受影響。
instagram-agent-skill 是什麼?
| 項目 | 內容 |
|---|---|
| Repo | Jakeschincariol/instagram-agent-skill |
| 作者/建立日 | Jake Schincariol,2026-09-13 |
| 授權 | MIT,免費、不用註冊、不用 API key |
| 熱度 | 3,778 星、814 forks(2026-10-30 查詢) |
| 13 個 Skill | /ig-reel、/ig-viral、/ig-caption、/ig-carousel、/ig-story、/ig-profile、/ig-plan、/ig-human、/ig-comment、/ig-reply、/ig-dm、/ig-repurpose、/ig-audit |
| 5 支 Python 工具 | hookscore.py(開場評分)、beats.py(腳本估時)、caption.py(文案預覽與檢查)、humanize.py(清 AI 套話)、detect.py(AI 味評分) |
| 發文 | 不發。每個 Skill 最後都是一段可複製的文字,你自己貼 |
swipe.py 給 /ig-viral 排序爆款用,README 算的「five Python tools」沒把它算進去,這次我也沒測它。
「不發文」是作者刻意的設計。README 的說法是:IG 官方的 Content Publishing API 要 Meta 開發者 app、連結粉專、長效 token 和 app 審查,不是一個 Skill 能給你的;其他自動發文、留言、追蹤的做法都是瀏覽器自動化或第三方工具,違反 Instagram 使用條款,帳號會被限制。/ig-viral 也一樣,它讓你用自己的瀏覽器、照人的速度看 10 個帳號,不爬蟲、不要你的密碼。
5 支 .py 我都看過 import,只用到 argparse、json、re、statistics、unicodedata、os、sys 這些標準庫,沒有網路請求也沒有 subprocess。
怎麼安裝 instagram-agent-skill?
README 給了三種裝法。Claude Code 手動裝是這兩行:
git clone https://github.com/Jakeschincariol/instagram-agent-skill.git
cp -r instagram-agent-skill/skills/ig-* ~/.claude/skills/
或用 plugin:
/plugin marketplace add Jakeschincariol/instagram-agent-skill
/plugin install instagram-agent
裝完之後,README 要你先花十分鐘填 templates/voice.md,複製到 ~/.claude/instagram/voice.md。每個 Skill 都會讀這個檔,它決定產出來的腳本像不像你講話。也可以丟三支自己的 Reel 給 Claude,請它幫你寫 voice.md。
沒有 Claude Code 的話,把任一份 SKILL.md 貼到對話最上面也能用,只是少了 Python 工具。
這次我沒有裝進 ~/.claude/skills/,而是 clone 到獨立資料夾,用 python -I 直接跑工具。README 範例寫的是 python3,在我這台 Windows 上 python3 指到 Microsoft Store 的空殼,執行後沒有任何輸出,要改用 python(我的版本是 3.11.9)。
英文實測:跟宣傳一樣能用
我準備了 5 句英文開場丟進 hookscore.py:
| 分數 | 判定 | 開場 | 工具抓到的問題 |
|---|---|---|---|
| 85.6 | STRONG | Nobody tells you that your first 30 reels are supposed to flop. | 最弱項 SPECIFICITY |
| 83.0 | STRONG | I replaced my $2,000/month editor with one free Claude skill. | 最弱項 ADDRESS |
| 81.4 | STRONG | I lost $18,000 because of one missing contract. | 最弱項 ADDRESS |
| 54.4 | OK | Stop scrolling if you want to grow on Instagram in 2026 🔥 | 用 stop scrolling 開場、開場放 emoji |
| 9.6 | WEAK | Hey guys, today I wanted to talk about content strategy | 用打招呼開場 |
套話清理也正常。我寫了一段塞滿行銷套話的英文段落,humanize.py 換掉 8 個(unlock→get、elevate→improve、in today's video 刪除…),破折號改成逗號,「It's not just X, it's Y」句型只標記不改。detect.py 的人味分數從 21.7 升到 38.8,仍然是 FLAGGED,因為段落裡沒有任何具體數字或專有名詞。
中文實測:5 支工具哪裡失效?
同樣的開場翻成中文、另外寫一份 137 字的中文腳本和一段套話段落,結果如下:
| 工具 | 英文 | 中文(原版) |
|---|---|---|
| hookscore | ✅ 排序合理,抓到打招呼 | ❌ 5 句全部 WEAK,「哈囉大家好」沒被抓成打招呼 |
| beats | — | ❌ 137 字腳本被算成 8 words · ~2.9s |
| humanize | ✅ 換掉 8 個套話詞 | ❌ 中文套話抓到 0 個,只把全形破折號換成半形「, 」 |
| detect | ✅ 21.7 → 38.8 | ❌ 85 個中文字的段落回「too short to judge」;只拿掉破折號,分數就從 30.0 跳到 62.0 |
| caption | — | ⚠️ 能跑,但預覽框中文對不齊,125 字的截斷點用字元數算 |
為什麼中文會被當成沒有字?
beats.py 第 29 行這樣定義「一個字」:
WORD_RE = re.compile(r"[A-Za-z0-9$%'’-]+")
只認英文字母、數字和幾個符號。中文腳本裡被算到的只有 Claude、Skill、instagram-agent-skill、GitHub、hookscore、caption、125、IG 這 8 個,再用每分鐘 165 個英文字的語速去換算,就得到 2.9 秒。
hookscore.py 和 detect.py 也是英文分詞的思路:長度、具體性、打招呼這些檢查都在數英文單字、比對英文詞庫,所以中文開場一律拿低分,「哈囉大家好」不在它的打招呼清單裡。humanize.py 的套話詞庫(slop.json,154 個詞)全是英文,中文段落自然一個都對不到。
Windows 繁中踩坑:碰到 emoji 直接 UnicodeEncodeError
在繁中 Windows 的終端機直接跑,開場裡有 🔥 的那一句會讓程式當掉:
File "...\skills\ig-reel\hookscore.py", line 263, in render_table
print(f"{mark} {r['score']:5.1f} {r['verdict']:<7} {hook}", file=out)
UnicodeEncodeError: 'cp950' codec can't encode character '\U0001f525' in position 44: illegal multibyte sequence
原因是 Python 的標準輸出沿用系統編碼 cp950,cp950 裡沒有 emoji。加 -X utf8 就好:
python -X utf8 skills/ig-reel/hookscore.py hooks.txt
不想每次加,可以設環境變數 PYTHONUTF8=1。
中文補丁 zh_ig.py 怎麼修?
我寫了一支 123 行的 zh_ig.py,先補最常用、也最好補的兩件事:腳本估時和中文套話清理。
估時的核心是改計量方式,中文字一個算一個,中文以外的英文單字另外算:
CJK = r"㐀-鿿豈-"
CJK_RE = re.compile(f"[{CJK}]")
ASCII_WORD_RE = re.compile(r"[A-Za-z0-9$%'-]+")
def units(text):
return len(CJK_RE.findall(text)) + len(ASCII_WORD_RE.findall(CJK_RE.sub(" ", text)))
預設語速每秒 4.5 字,這是我設的預設值,不是量出來的,可以用 --cps 依自己的講話速度調。同一份腳本跑出來是 137 字、約 30.4 秒,並多抓到三件事:開場那句要 4.4 秒,超過 3 秒;第二拍單拍 13.6 秒,要切或換畫面;結尾有呼應開場的「剪輯」,影片可以 loop。
python -X utf8 zh_ig.py beats script.txt --target 30 --cps 4.5
python -X utf8 zh_ig.py slop draft.txt --out clean.txt
套話清理用一份中文詞庫做替換,結構性的問題只標記不改。同一段中文套話段落,補丁抓到 10 處,例如「在今天的影片中」刪除、「解鎖你的潛能」改成「做得更好」、「演算法最愛」改成「IG 會推」、「記得追蹤我」刪除;另外標出「不僅是 X,更是 Y」句型、3 個 🚀、一組三連排比。
補丁的限制
自動替換之後句子會變生硬。實際輸出裡有一句變成「做得更好、讓品牌被記住、幫你的成長。」,意思還在,但讀起來不像人寫的,還是要自己潤。
hookscore、detect、caption 這三支我沒補。detect 的分數對中文沒有意義,只拿掉兩個破折號就加了 32 分,補它需要重新設計五項指標,不是換個 regex 的事。
完整的中英對照輸出放在 html.yanchen.app/ig-agent-skill-zh。
hook 評分能挑出會爆的開場嗎?
不能,作者自己在 README 寫清楚了。他用 5 個頻道、各自表現最好和最差的 8 支短影音、共 74 個真實開場去測:
| 測什麼 | 結果 |
|---|---|
| 抓刻意寫爛的 10 個開場 | AUC 0.83,10 個裡有 9 個低於真實開場的中位數 |
| 從同一個創作者的爆款和失敗作裡挑贏家 | AUC 0.56(0.50 等於擲硬幣) |
| 開場公式分類器 | 原本只認得 8% 的真實開場,照真人逐字稿重寫 regex 後到 49% |
這段跟語言無關。就算之後有人把 hookscore 補成中文,它能做的也是同一件事:擋爛開場,不負責挑爆款。
那支 Reel 為什麼留言比讚多 5 倍?
320 個讚、1,694 則留言,留言數大約是讚的 5.3 倍。原因寫在貼文裡:留言「Reel」,作者私訊你完整教學。
這正好是 repo 裡 /ig-dm 教的第一種私訊:對方先留了關鍵字(README 說 IG 官方工具與認可的合作夥伴支援這種關鍵字自動回覆),你再回一則私訊。用這套 Skill 的推廣片本身就跑著 Skill 教的漏斗。
我該不該裝?
| 你的情況 | 建議 |
|---|---|
| 用英文經營 IG | 直接裝,5 支工具照 README 用 |
| 用中文經營 IG,想要一套提示詞骨架 | 裝。13 份 SKILL.md 是提示詞,先填好 voice.md,中文 Claude 照樣能產出腳本、文案、週計畫 |
| 用中文經營 IG,想靠 Python 工具量化 | 原版工具的數字不要信;估時和套話清理改用中文版工具,hook 評分只當參考 |
| 想要 AI 幫你自動發文 | 這個 repo 刻意不做,也不建議你找會做的工具 |
延伸資源
- instagram-agent-skill GitHub repo:README 後半段「What I actually measured」和「The fine print」值得讀完
- 中英對照實測結果頁:5 支工具的完整輸出
- Instagram 使用條款:自動化操作的界線
- Claude Code 的 find-skills 怎麼找 Skill:裝別人的 Skill 之前先看清楚它做什麼