Markusgjesdal/listing-writer

商品ファイルを読み込み、事実に基づいたデジタルプロダクトのストアリスティングを生成します(タイトル、サマリー、説明、内容一覧、FAQ、タグなど)。

listing-writer とは?

Listing Writerは、デジタルプロダクト(テンプレート、PDFガイド、印刷可能な素材、コードパック、プロンプト/スキルパック、スプレッドシートなど)のフォルダを読み取り、誇張ではなくファイル内の事実に基づいたストアリスティングを自動生成するスキルです。ユーザーが「リスティングを書いて」「テンプレート/ガイド/パックの商品説明を」などと依頼した際に起動し、`listing.md`を出力します。主な対応プラットフォームはGumroad、Etsy、Notionテンプレートストアなど、デジタル商品を扱うECサイト全般です。このスキルは、商品のファイルを再帰的に列挙して正確な在庫リストを作成し、3つのタイトル候補、160文字以内のサマリー、問題提起・解決策・使い方を3段落で構成する説明、FAQ、タグなどを生成します。虚偽の収益保証や口コミ、限定感を演出する表現は禁止され、すべての数値はファイルから取得するかユーザー確認が必要で、未確認の情報は`[ASK USER: ...]`として残されます。最終出力前に`checklists/claims-check.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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

リスティングライター (Listing Writer)

商品ファイルのフォルダを、購入者が何を得られるかを明確に伝えるストアリスティングに変換します。このリスティングはファイルから見つかった事実に基づいて構築され、誇大表現は使いません。出力:listing.md(商品フォルダの隣に配置)。

使用するタイミング

  • デジタルプロダクト(テンプレート、PDFガイド、印刷可能な素材、コードパック、プロンプトまたはスキルパック、スプレッドシート)が完成し、ストア用のコピーが必要なとき。
  • 古いリスティングをゼロから書き直したいとき。(既存のリスティングをスコアリングして修正するには、代わりに listing-audit を使用します。入手可能な場合。)

使用しないタイミング

  • プロダクトがまだ完成していない場合。リスティングはファイルが存在した後に書き、すべての主張をファイルと照合して確認できるようにします。

入力

  • 必須: プロダクトフォルダまたはzipファイルへのパス。
  • ファイル内に見つからない場合は1回だけ質問: 誰のための製品か(一文)、価格または価格帯、掲載するストア、購入者が既に持っているべきもの(ソフトウェア、アカウント、スキルレベル)。
  • 任意: ユーザー自身のメモ、古いリスティング、スクリーンショットリスト、ユーザーが提示できる実際の顧客フィードバック(ユーザーが本物で引用を許可したと確認したフィードバックのみ使用)。

手順

  1. プロダクトの在庫を確認する。 購入者が受け取るすべてのファイルを列挙します(フォルダとzipは再帰的に探索)。ページ数、シート数、テンプレート数、スキル数など、単位を数えます。フォーマットと必要なソフトウェアをメモします。最初にこのリストを書き留めてください。これが残りの作業の真実の源となります。
  2. ジョブを見つける。 一文で、このプロダクトを使って購入者がより速く、またはより良く完了できるタスクを述べます。もし見つけられなければ、他のことを書く前にユーザーに質問します。
  3. templates/listing-template.md をセクションごとに埋めます。
    • タイトル候補(3つ): 70文字未満、結果またはモノで始め、フォーマットを含める(例:「Notionテンプレート」、「PDF」、「スキルパック」)。すべて大文字、絵文字の壁、「究極/最高/#1」は、ユーザーが証明できない限り使用禁止。
    • サマリー: 一文、160文字未満、ストアの短い説明と検索スニペットとして使用可能。
    • 説明: 3つの短い段落:購入者の言葉での問題、このプロダクトがそれに対して何をするか、その使い方(手順または短い例)。
    • 内容一覧: 手順1の在庫のみから作成された箇条書きリスト。実際の数を含む。
    • 対象者 / 対象外: それぞれ2〜4個の箇条書き。「対象外」は信頼を築き返金を減らします。
    • 要件: ソフトウェア、バージョン、アカウント、スキルレベル。
    • FAQ: 購入者が実際に尋ねるであろう4〜6の質問(フォーマット、返金、アップデート、互換性、ライセンス、サポート)。ユーザーが確認した事実のみで回答。そうでなければ [ASK USER] とマーク。
    • タグ: 人々が入力するであろう8〜12の小文字検索フレーズ。競合他社やブランド名は、互換性としてのみ使用。
  4. checklists/claims-check.md を下書きに対して実行し、ヒットした箇所をすべて修正します。
  5. ギャップをマークする。 確認できなかった事実は、テキスト内で [ASK USER: ...] のままにします。推測で埋めてはいけません。
  6. listing.md を書き、ユーザーに3行のチャットサマリーを提供します:選択したタイトル、[ASK USER] 項目の数、主張チェックで確信が持てなかったもの。

出力

listing.md に以下のセクション:タイトル候補、サマリー、説明、内容一覧、対象者、対象外、要件、FAQ、タグ、未解決の質問。

ルール

  • リスティング内のすべての数字は、在庫またはユーザーからのものでなければなりません。
  • 収入や結果の約束は禁止(「$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.

関連スキル