writing-beats

writing-beatsスキルの概要

writing-beats は、Markdownの生メモを、1ビートずつ記事に仕立てていくための下書きワークフロースキルです。すでに素材はあるものの、一直線の論証ではなく、読みやすい物語として形に整えたいライター、編集者、エージェントに向いています。主な役割は「記事全体を書き切る」ことではなく、「次に最適な一手を選び、その一手を書き、次の進み方を決める」ことです。

writing-beatsスキルは何に使うか

散らばった要点、インタビューのメモ、リサーチの断片、ラフなアウトラインがあり、それらをリズムと抑制の効いた展開を持つ記事にしたいときに writing-beats スキルを使います。特に、いきなり完成稿を起こすと粗すぎる、または早すぎるという場面で有効です。探索的な解説、創業者ストーリー、ケーススタディ、そして Blog Writing 向けの writing-beats に向いています。

通常のプロンプトと何が違うか

一般的なプロンプトは、一気通貫の文章を出しやすい一方で、記事がどう展開していくべきかという構造を落としがちです。writing-beats のインストールガイドが重要なのは、スキルが段階的な判断を強制するからです。候補となるビートを出し、1ビートずつ書き、記事にすでに何が含まれているかに応じて次の方向へ切り替えます。そのため、流れが「雑に吐き出してから磨く」のではなく、より編集的で、より計画的になります。

向いているケースと向かないケース

向いているのは、何を先に置くべきか、何を続けて書くべきか、どこで終えるべきかという「並べ方」に一番悩んでいる場合です。逆に、白紙から完成記事を一発でほしい場合、厳密なスキーマ出力が必要な場合、あるいは素材メモがまったくない場合には向きません。生の材料がなければ、スキルが形にする対象そのものがありません。

writing-beatsスキルの使い方

スキルをインストールして開く

skill manager で writing-beats のインストールフローを使い、まず skills/in-progress/writing-beats/SKILL.md を開きます。このリポジトリには補助スクリプトや参照フォルダがないため、スキルの挙動はほぼこの1ファイルで決まります。テストに入る前に、まずここを読むのが最優先です。もし環境上の skills の置き場所が別なら、同じワークフローをローカルパスに対応させ、ビートのループ構造は崩さないでください。

スキルに適した入力を渡す

このスキルは、Markdownの生素材を渡したときに最もよく働きます。ノート、箇条書き、抜粋、ラフな記事下書きなどです。writing-beats をしっかり使いたいなら、想定読者、記事の目的、そして「最後は提言で終える」「専門用語を避ける」「導入は顧客の課題から入る」といった強い制約も含めてください。そうした条件があると、最終形に合うビートを選びやすくなります。

ビート単位のワークフローを実行する

writing-beats の基本手順はシンプルです。

1. 生素材ファイルを渡す。
2. 保存先のパスが指定されていなければ、スキルの1回限りのパス質問に答える。
3. 2〜3個の開始ビート候補を確認する。
4. 1つ選び、そのビートだけを書かせ、更新された記事ファイルを読む。
5. 次の2〜3個の候補を確認し、自然に終わるまで続ける。

この方法の重要な利点は、各判断点でいったん止まることです。そのおかげで、導入が長すぎる問題や、不自然なつなぎが起きにくくなります。

出力品質を上げる入力のコツ

Blog Writing 向けの writing-beats をよりよく使うには、複数の入り口を支えられるだけの素材を入れてください。たとえば、次のようなプロンプトのほうが強いです。「このメモを使って、プロダクトマーケター向けのナラティブ記事を書いてください。製品の歴史ではなく、顧客の痛みから始めてください。トーンは実務的に保ち、提言が確立したところで止めてください。」これなら、「これを記事にして」よりも、どのビートを選ぶべきかが明確になります。

writing-beatsスキルのFAQ

writing-beats はブログ記事専用ですか？

いいえ。writing-beats スキルは、段階的な構成が効くあらゆるナラティブ作品に使えます。解説記事、ケーススタディ、ソートリーダーシップ、ローンチストーリー、社内向けのまとめ記事などです。ブログはよく合う用途ですが、本質は「制御された順序づけ」にあります。

writing-beats のインストールで実際に何が手に入りますか？

writing-beats のインストールで手に入るのは、完成済みのテンプレートではなくワークフローです。エージェントに対して、どのようにビートを選ぶか、各ステップでどれくらい書くか、いつ止まって次の方向を求めるかを指示します。これは通常のプロンプトとは違い、判断ループそのものがスキルの一部になっている点が特徴です。

使う前に、メモはきれいに整えておく必要がありますか？

いいえ。ただし、実際の材料は必要です。ラフな箇条書きでも、ビート選択を支えられるだけのシグナルがあれば十分です。ソースが薄すぎると、スキルが構成を補うしかなくなり、そのぶん結果は弱くなります。

writing-beats を使わないほうがいいのはどんなときですか？

一発要約、固定アウトライン、完全自動の長文下書きを求めるなら使わないでください。記事の流れを編集的にコントロールしたいとき、そして進行に合わせて次のビートを承認する意志があるときに最も強いスキルです。

writing-beatsスキルの改善方法

最初のビートの前にソースを強くする

品質を左右する最大のレバーはソース素材です。具体例、主要な主張、重要な転換点、そして「必ず入れる」要素を含めてください。メモが大きなテーマだけだと、スキル自体は動きますが、ビート選択が曖昧になり、記事が反復的に感じられることがあります。

記事の形をあらかじめ絞り込む

結末を重視するなら、最初にそう伝えてください。ゆっくり立ち上げたいのか、課題起点の導入にしたいのか、途中で意外性を見せる構成にしたいのかも、プロンプトで指定します。writing-beats は、話題だけでなく、記事がどんな道筋をたどるべきかを知っていると、より良く機能します。

ありがちな2つの失敗パターンに注意する

1つ目はビートの肥大化です。1ビートに書きすぎてしまい、あとからの切り替えが不自然になります。2つ目はビートの同質化です。各セクションが言い回しを変えただけで同じことを言ってしまう状態です。どちらも直すには、次のビートをもっと狭く指定する、次のソース箇所を示す、あるいはそのビートが1文で何を達成すべきかを明確に伝えるのが有効です。

最初の下書きのあとで反復する

最初の数ビートを書いたら、記事をバラバラの段落としてではなく、連続した流れとして読み直してください。つなぎが弱いなら、次のビートに特定のギャップを埋めさせます。記事が停滞しているなら、主張を前進させるか、記事を締めるビートを求めます。writing-beats が最も役立つのはここです。構造が固まり切る前に、下書きをこちらで舵取りできるからです。