1仕組みと動作原理

本テンプレートは「フォルダ＝テンプレート」構造における純粋なデータです。SKILL.mdはセレクター用のYAML frontmatterを備え、本文はエージェント向けのレイアウト指示で構成されています。リポジトリは個々のテンプレート用コードを一切持たず、テンプレートの追加はフォルダの新規作成のみで完了します。

next/src/lib/templates/loader.ts

SKILL.md — frontmatter (id, scenario, tags, …) + prompt body

loader.tsのファイル先頭コメントにディレクトリ規約が明記されています。frontmatterはプロセス内正規表現でパースされ（YAML依存関係なし）、本文はプロンプト本文としてそのまま抽出されます。フロントエンドには送信されません（「Body is excluded so we can return the entire registry in one cheap fetch without shipping prompt text to the browser.」）。

実行時はホスト側が本テンプレートの本文を共有デザイン指示とユーザーコンテンツの間に挟み込み、1つのプロンプトとして結合します。テンプレートの「インテリジェンス」はすべてこの自然言語にあり、実行可能コードは含まれません。

next/src/lib/templates/shared.ts

return `${SHARED_DESIGN_DIRECTIVES} ${opts.body.trim()}

assemblePromptの戻り値は「共有デザイン指示＋テンプレート本文＋【入力形式】＋【ユーザーコンテンツ】」となります。共有セクション（同一ファイル内のSHARED_DESIGN_DIRECTIVES）は、単一ファイルHTML、Tailwind/フォントCDN、コンテンツ駆動型の数量、ファイルシステムツールの使用禁止などの厳格な要件を担当し、全テンプレート共通であり本テンプレート固有のものではありません。

ホストの/api/convertが本テンプレートをロード後、これらのテキストをローカルでログイン済みのcoding-agent CLIに渡し、stdoutのみをHTMLとしてストリーミング回収します。テンプレート自体は通信を行わず、認証情報を読み取らず、ファイル書き込みもしません。

next/src/app/api/convert/route.ts

prompt = assemblePrompt({ body: skill.body, content, format });

同じルートがその後invokeAgent({ … })を呼び出してCLI（ホストのPATHから検出されたclaude / codex / cursor-agentなど）を起動します。これに伴う共有指示にも「**Write / Edit / MultiEdit / Bash / Create / いかなるファイルシステムツールの使用も禁止**」と明記されています。

テンプレートに付属するexample.htmlは「事前レンダリングされたサンプル」であり、プレビューAPIからそのまま返され、セレクターやギャラリーのiframeに読み込まれます。テンプレートカードに視覚的なプレビューが存在するかどうかを決定するもので、コンテンツ生成には関与しません。

next/src/app/api/templates/[id]/preview/route.ts

Returns the skill's `example.html` verbatim so it can be loaded into an

プレビューはskill idごとにキャッシュされます（Cache-Control: public, max-age=300）。フロントエンドはプレビューパネルのiframeにsandbox="allow-scripts allow-same-origin"を付与しています（ホスト側の実装であり、本テンプレートからは制御不能）。

frontmatterのフィールドはセレクターのメタデータへと順次マッピングされ（featuredは全体ソート順、recommendedは上部「★ おすすめ」グループへの登録、example_*はサンプルカードの文面生成）、カテゴリやシナリオフィルターでの表示位置を決定します。

next/src/lib/templates/loader.ts

if (typeof fm.featured === "number") meta.featured = fm.featured;

fmToMetaはcategory/scenario/aspectHint/tagsを直接SkillMetaに転送します。exampleブロックはexample_idまたはexample.{md,html}が存在する場合に生成されます（id/name/format/tagline/desc ＋任意のsource）。これらのフィールドは表示とソートにのみ影響し、生成の動作には影響しません。

本テンプレートの生成能力はすべて自身の本文によって実現されています。social-x-post-card/SKILL.mdはレイアウト、配色、フォント、コンテンツ規律のみを記述しており、エージェントにツールの実行、API取得、外部データの読み取りを促す指示は一行もありません。