Community生產力與協作github.com

Markusgjesdal/listing-writer

讀取數位產品的檔案,為其撰寫完整、誠實的商品頁面文案(標題選項、一句話摘要、描述、內容物、適用對象、常見問題、標籤)。

listing-writer 是什麼?

這個技能會自動掃描數位產品資料夾中的所有檔案,根據實際內容建立一份誠實且完整的商品頁面文案(listing.md)。它專為模板、PDF 指南、可列印素材、程式碼包、提示詞或技能包、試算表等數位產品而設計。與其使用誇大不實的行銷用語,Listing Writer 只從檔案的實際事實中提取資訊,確保每個數字和宣稱都可驗證。它支援產生多個標題選項、簡短描述、詳細說明、內容物清單、目標與非目標客群、系統需求、常見問題以及搜尋標籤。這個技能會自動比對一份宣稱檢查清單,並標記任何無法從檔案或使用者確認的項目,藉此建立信任、減少退貨。最終輸出是位於產品資料夾旁的 listing.md 檔案,文案簡短、利於手機瀏覽。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Markusgjesdal/shelfwright-lite/tree/HEAD/skills/listing-writer

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Listing writer

將產品檔案資料夾轉換為商店頁面文案,清楚說明買家會獲得什麼。文案僅根據檔案中的事實建立,而非誇大宣傳。

輸出:listing.md,位於產品資料夾旁。

使用時機

  • 數位產品(模板、PDF 指南、可列印素材、程式碼包、提示詞或技能包、試算表)已完成,需要商店文案。
  • 需要從頭重寫舊的商店文案。(如果您需要的是對現有文案進行評分和修正,請改用 listing-audit,如果您有此技能的話。)

不應使用時機

  • 產品尚未完成。請等到檔案存在後再撰寫文案,如此才能根據檔案驗證每一項宣稱。

輸入

  • 必要: 產品資料夾或壓縮檔的路徑。
  • 若檔案中找不到,則詢問一次: 產品適用對象(一句話)、價格或價格範圍、上架的商店,以及買家必須具備的條件(軟體、帳戶、技能水準)。
  • 選用: 使用者自己的筆記、舊的文案、螢幕截圖清單、使用者可以出示的真實客戶回饋(僅使用使用者確認是真實且允許引用的回饋)。

步驟

  1. 盤點產品。 列出買家將收到的每個檔案(遞迴搜尋資料夾和壓縮檔)。計算頁數、工作表、模板、技能或任何單位。記下格式和任何所需的軟體。先寫下這份清單:它是後續所有內容的事實來源。
  2. 找出任務。 用一句話說明買家使用此產品能更快或更好地完成什麼任務。如果您無法確定,請在使用者撰寫任何其他內容之前詢問。
  3. 依序填寫 templates/listing-template.md 的各個章節:
    • 標題選項(3 個): 70 個字元以內,以成果或產品本身開頭,包含格式(例如「Notion 模板」、「PDF」、「技能包」)。不全部大寫、不使用過多表情符號、不使用「終極/最佳/#1」,除非使用者能證明。
    • 摘要: 一句話,160 個字元以內,可作為商店的簡短描述和搜尋片段。
    • 描述: 3 個短段落:從買家的角度描述問題、產品如何解決這個問題、如何使用(步驟或簡短範例)。
    • 內容物: 僅根據步驟 1 中的盤點結果製作的項目符號清單,附上實際數量。
    • 適用對象 / 不適用對象: 各 2-4 個項目符號。「不適用對象」能建立信任並減少退款。
    • 需求: 軟體、版本、帳戶、技能水準。
    • 常見問題: 4-6 個買家真正會問的問題(格式、退款、更新、相容性、授權、支援)。僅使用使用者確認的事實來回答;否則標記為 [ASK USER]。
    • 標籤: 8-12 個小寫的搜尋詞組,除非用於相容性說明,否則不包含競爭對手或品牌名稱。
  4. 對草稿執行 checklists/claims-check.md,並修正所有找到的項目。
  5. 標記缺口。 任何您無法驗證的事實都保留為文中的 [ASK USER: ...]。請勿自行猜測填入。
  6. 寫入 listing.md,然後向使用者提供 3 行的聊天摘要:選擇的標題、[ASK USER] 項目的數量、以及宣稱檢查中您不確定的任何事項。

輸出

listing.md,包含以下章節:標題選項、摘要、描述、內容物、適用對象、不適用對象、需求、常見問題、標籤、未解決問題。

規則

  • 文案中的每一個數字都必須來自盤點結果或使用者。
  • 不得承諾收入或成果(「賺 X 元」、「保證」、「爆紅」)。描述產品能做什麼,而非買家會獲得什麼。
  • 不得編造評論、推薦、買家數量、「限時」或「僅剩 N 個」。
  • 其他公司的產品名稱僅能作為相容性事實出現(「可與……搭配使用」),絕不能以暗示背書的方式出現。
  • 為在手機上快速瀏覽的使用者撰寫:短段落、白話、不要用一堆粗體字。
  • 切勿自行發布或貼到商店。使用者會自行操作。

本技能包含的檔案

  • templates/listing-template.md — 用於填入 listing.md 的結構。
  • checklists/claims-check.md — 需搜尋並修正的項目清單,交件前執行。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能