writing-shape
作者 mattpocockwriting-shape 是一個對話式起稿 skill，適合把 markdown 原始素材整理成可發佈的文章。它可協助你挑選開頭、逐段展開內容，以及為 Technical Writing、訪談筆記、逐字稿清理和粗稿做結構取捨。當你需要的是有引導的編輯流程，而不是一次性的 prompt 時，就適合使用 writing-shape guide。
這個 skill 的評分是 68/100，代表它可以列入目錄，但建議保留使用上的注意。對於想把原始 markdown 筆記、逐字稿或粗稿，透過引導式對話流程整理成可發佈文章的使用者，它有清楚的適用情境；不過目前內容多半是純文字規格，支援素材有限，也沒有安裝指令或輔助腳本。
- 觸發條件明確：它清楚說明，當使用者手上有 markdown 原始素材，想把內容整理成文章時，就該用這個 skill。
- 工作流程寫得很具體：先完整閱讀輸入，再草擬 2–3 個候選開頭，接著逐段擴寫內容。
- 安裝判斷價值高：它提醒原始素材檔是唯讀的，而文章應在這次 session 中另外存成獨立檔案。
- 沒有提供支援檔或腳本，因此 agents 必須完全依賴 `SKILL.md` 的指示。
- repository 位於尚在進行中的路徑，且缺乏範例與參考資料，這會降低在邊界情況與最終潤飾上的信心。
writing-shape 技能總覽
writing-shape 是一種對話式起草技能，能把一大段 markdown「素材堆」逐步整理成可發布的文章，每次只先處理一個結構選擇。它特別適合已經有原始材料，但還需要幫忙找出角度、開頭與整體架構的寫作者、技術行銷人員與編輯。
這個 skill 是用來做什麼的
當工作不是「從零寫一篇」，而是「把這些零散素材整理成通順內容」時，就該用 writing-shape。它很適合訪談筆記、逐字稿整理、草稿片段，以及需要先強化敘事脈絡、再完成定稿的技術寫作。
它有什麼不同
writing-shape 不只是摘要原始筆記。它會先讓你在幾個候選開頭之間做選擇，接著一邊推進文章、一邊逐段討論結構。這讓它特別適合那些順序、重點與格式和事實本身同樣重要的寫作情境。
最適合的情境與限制
當你想把雜亂輸入整理成一篇可讀文章時，這個 skill 很適合 Technical Writing，但它不能取代主題判斷。如果你只需要沒有討論過程的潤稿，通用提示詞可能更快；如果你要的是一套有引導的編輯流程，writing-shape 會是更合適的安裝選擇。
如何使用 writing-shape skill
安裝與會話設定
使用 npx skills add mattpocock/skills --skill writing-shape 安裝。接著在開始會話時，把原始 markdown 檔與目標文章路徑一起提供給它；如果你還沒決定，也可以請它幫你選。這個 skill 預設原始素材是唯讀的，而且在每次寫入前都會重新讀取文章檔。
要提供哪些輸入
writing-shape 最好的使用方式，是一開始就給它三樣東西：原始筆記、目標讀者，以及你希望產出的文章結果。比起「幫我改好一點」，像「把這些筆記整理成一篇給新平台工程師看的實用指南」會更有效，因為它同時提供了 thesis、讀者與可優化的細節層級。
建議工作流程
先打開來源檔，完整讀一遍，然後讓 skill 提出 2–3 個候選開頭。選出最符合這篇文章實際任務的開頭，再一步一步往下推，持續問下一段讀者最需要什麼。這個迴圈正是 writing-shape 最有價值的地方：它能讓文章保持錨定，同時在草稿浮現時持續調整結構。
先讀哪些檔案
先打開 SKILL.md，再檢查 skill 可能引用的其他倉庫說明，例如 README.md、AGENTS.md 和 metadata.json（如果存在）。在這個 repository 裡，真正的重點其實就在 SKILL.md 本身，所以實務上的判斷不是「找有沒有隱藏助手」，而是「理解起草迴圈，並乾淨地套用它」。
writing-shape skill 常見問題
writing-shape 只適合 markdown 輸入嗎？
它是圍繞 markdown 檔設計的，但這個「素材堆」也可以是逐字稿、筆記，或先轉成 markdown 的粗稿。關鍵要求是：在開始整理之前，來源內容要能先被當成一整份完整材料讀懂。
這跟一般提示詞有什麼不同？
一般提示詞通常是在一次回合內直接要成稿。writing-shape 則是引導一個迭代式編輯流程：會先選開頭，再談段落順序與格式取捨，因此通常能從雜亂素材做出更有意圖感的文章。
writing-shape 適合初學者嗎？
適合，只要使用者能提供原始素材，並回答幾個編輯問題。它特別適合那些知道自己手上有什麼，但還不太知道該怎麼把內容組織成一篇有說服力文章的初學者。
什麼情況下不該用？
當內容本來就已經結構明確、沒有真正需要整理的素材堆，或者你需要的是一次完成的摘要，而不是一篇逐步成形的文章時，就不適合用 writing-shape。它最有價值的時機，是草稿還需要先決定「長什麼樣子」，而不只是做清理。
如何改進 writing-shape skill
給它更精準的編輯簡報
writing-shape 最好的結果來自清楚的承諾：文章是寫給誰、要解決什麼問題、最後應該變成哪一種文章。只要你能先講清楚受眾和結果，skill 就能選出更好的開頭，並讓後面的段落一直維持一致。
提供更好的原始素材
常見失敗模式是來源素材太廣、太重複，或混進了無關研究。正式啟用 skill 前，先刪掉明顯雜訊，把最相關的 markdown 片段放在一起；如果來源本來就有多個主題，也先幫它們標好段落。更好的輸入能減少分支過多的草稿，讓整理對話更果斷。
調整結構，不要只改字句
如果第一版看起來不對，別只說「幫我寫得更好」。更有效的方法是調整 thesis、重新排列段落重點，或改變文章格式的期待。writing-shape 最能發揮作用的方式，是先修正文意架構，再處理句子。
保留文章檔
因為這個 skill 預期在每次寫入前都會重新讀取文章文件，所以修改應該留在那個檔案裡，而不是只靠聊天處理。這個習慣可以保護使用者的改動、讓協作更安全，也能讓 writing-shape 在較長的起草過程中持續發揮作用。