writing-shape

writing-shape skill の概要

writing-shape は、markdown の「素材の山」を、構成を一手ずつ決めながら公開可能な記事へと整える対話型の下書き作成スキルです。すでに元になる素材はあるが、切り口、書き出し、最終的な形を見つけたいライター、テクニカルマーケター、編集者に最適です。

何のためのスキルか

writing-shape を使うべきなのは、「ゼロから書く」仕事ではなく、「荒い素材を筋の通った形にする」仕事です。インタビューのメモ、文字起こしの整理、下書きの断片、そして、完成前にもっと強いストーリー性が必要なテクニカルライティングでよく機能します。

何が違うのか

writing-shape skill は、単に元メモを要約するだけではありません。候補となる冒頭を選ばせ、そのうえで構成を議論しながら段落ごとに記事を組み立てていきます。そのため、事実そのものと同じくらい、並べ方、強調、形式が重要な文章づくりに向いています。

向いているケースと限界

読みやすい記事を雑多な入力から作りたいときの Technical Writing にはよい選択です。ただし、専門的な判断そのものの代わりにはなりません。議論抜きで洗練された文章だけが欲しいなら、一般的なプロンプトのほうが速いこともあります。逆に、編集の進め方まで案内してほしいなら、writing-shape を入れる価値があります。

writing-shape skill の使い方

インストールとセッション設定

npx skills add mattpocock/skills --skill writing-shape でインストールします。そのあと、元の markdown ファイルと、出力先の記事パスを渡してセッションを始めるか、まだ未定なら候補の選定を依頼します。このスキルは、元素材を読み取り専用として扱い、書き込みのたびに記事ファイルを再読する前提で動きます。

何を入力すればよいか

writing-shape の効果が最も高いのは、元メモ、想定読者、完成形のゴールという 3 点がそろっているときです。たとえば「このメモを、新規のプラットフォームエンジニア向けの実践ガイドに整えて」と伝えるほうが、「もっとよくして」だけよりはるかに有効です。スキルが、どの主張を軸にし、誰向けに、どの程度の詳しさで最適化すべきかを判断しやすくなるからです。

おすすめの進め方

まず元ファイルを最初から最後まで読み、スキルに 2〜3 個の冒頭案を出させます。記事が本当に果たすべき役割に合う冒頭を選んだら、その後は一段ずつ「次に読者が知るべきことは何か」を確認しながら進めます。writing-shape が最も力を発揮するのはこの循環です。記事の軸を保ちながら、草稿の進行に合わせて構成を組み替えられます。

最初に読むファイル

まず SKILL.md を開き、そのあとで、このスキルが参照している近接リポジトリのガイド、たとえば README.md、AGENTS.md、metadata.json があればそれらも確認します。このリポジトリでは、実際の価値は SKILL.md 自体にあります。したがって、実務上の判断は「隠れた補助ファイルを探す」ことではなく、「下書き作成の流れを理解して、自然に適用する」ことです。

writing-shape skill FAQ

writing-shape skill は markdown 入力専用ですか？

基本設計は markdown ファイルですが、「素材の山」は、文字起こし、メモ、あるいは markdown に整形した荒い文章でも構いません。重要なのは、形を整える前に、素材全体を一つのまとまりとして読める状態になっていることです。

通常のプロンプトと何が違いますか？

通常のプロンプトは、1 回で完成稿を求めることが多いです。一方で writing-shape は反復型の編集セッションを案内します。冒頭の選定、段落の順番、形式の議論が作業の途中で起こるため、雑多な入力からでも、より意図のある記事に仕上がりやすくなります。

writing-shape skill は初心者にも向いていますか？

はい、元素材を用意できて、いくつかの編集上の質問に答えられるなら向いています。特に、何を持っているかは分かっているが、それをどう組み立てれば説得力のある記事になるかはまだ分からない、という初心者に役立ちます。

使わないほうがよいのはどんなときですか？

すでに構成がきれいに固まっているとき、整えるべき本当の素材の山がないとき、あるいは育てながら作る記事ではなく 1 回で要約したいだけのときは、writing-shape は向きません。最も価値が出るのは、単なる手直しではなく、まだ形を決める必要がある草稿です。

writing-shape skill を改善する方法

編集ブリーフをもっと明確にする

writing-shape で良い結果を出すには、「この記事は誰向けか」「どんな課題を解決するか」「どんな種類の記事にするか」がはっきりしていることが重要です。最初に読者と成果物を言語化できれば、よりよい冒頭を選び、後続の段落の方向性も揃えやすくなります。

素材の質を上げる

よくある失敗は、元の素材が広すぎる、重複が多い、あるいは関係ない調査メモが混ざっていることです。スキルを使う前に、明らかなノイズを削り、関連性の高い markdown の断片をまとめ、複数のテーマがあるなら見出しで分けておきます。入力がよくなるほど分岐の多い草稿を防げ、構成を決める対話もより鋭くなります。

文面だけでなく構成を反復する

最初の草稿に違和感があるときは、「もっと良い文章にして」とだけ頼まないほうがよいです。代わりに、主張を組み替える、展開順を変える、記事フォーマットへの期待を変更するといった調整を行います。writing-shape は、まず論旨の形を直し、そのあとで文を磨くと、最も改善しやすくなります。

記事ファイルを保持する

このスキルは、書き込みのたびに記事ドキュメントを再読する前提なので、編集はチャットではなくそのファイル内で続けるべきです。この習慣はユーザーの変更を守り、共同作業を安全にし、writing-shape を長めの下書きセッションでも有効に保ちます。