Communitygithub.com

YuukiMarine/websiteskills

会話を通じてウェブサイトを構築・デプロイします。要件を収集し、検証済みの site.json を生成し、Sitesmith テンプレートでレンダリング、Nginx で公開します。「サイトを作って」「ランディングページ」「個人・ビジネスサイト」「ポートフォリオ」などの依頼に使用します。

websiteskills とは?

Sitesmith は、対話数回で完成度の高い(オプションでバイリンガル対応の)静的ウェブサイトを構築・公開する AI エージェントスキルです。コードではなくデータ(site.json)を出力し、固定テンプレートでレンダリングするため、出力が安定し、後からデザイン変更も容易です。ユーザーの要望をグループ化した質問で効率的に収集し、単一ページまたは複数ページ+ブログの構成を選択可能。検証・レンダリング・デプロイ用のスクリプトが用意されており、Nginx + HTTPS で即座に公開できます。対応プラットフォームは Node.js と Nginx が動作する環境で、主に Claude Code や Cursor、Codex などの AI エージェントから利用することを想定しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skill

お気に入りのAIに質問する

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

ドキュメント

Sitesmith — 会話型ウェブサイトビルダー

数回の会話で、完成した(オプションでバイリンガル対応の)ウェブサイトを構築し、公開します。コードではなくデータ、すなわち単一の site.json を生成します。この JSON は固定の、よく設計されたテンプレートによってレンダリングされるため、出力が安定し、後から見た目を変更することも容易です。

使用するタイミング

ユーザーがウェブサイト、ランディングページ、個人・ビジネスサイト、ポートフォリオを作成・更新したい場合。例:「サイトを作って」「我想做个网站」「ホームページを更新して」「パン屋のランディングページを作って」。

クイックリファレンス

参考ファイル — skill_view("sitesmith", "<パス>") で必要に応じて読み込んでください。

  • references/site.schema.json — すべての site.json が満たすべき契約(スキーマ)
  • references/sections.md — 14 種類のセクションタイプ(posts を含む):使用タイミング、フィールド、コピーの制限
  • references/theme.md — テーマトークン(テンプレート、色、フォント、角丸、密度)
  • references/assets.md — 画像戦略(プレースホルダー / Unsplash;アセットの捏造禁止)
  • references/examples/innoe.site.json — 完全な単一ページの例(Few-shot 用)
  • references/examples/multipage.site.json — 複数ページ+ブログの例(Few-shot 用)

スクリプット — ターミナルツール経由で実行します。

アクションコマンド
バリデーションnode ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json>
レンダリングnode ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir>
デプロイbash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <domain>

手順

  1. ヒアリング(3〜5ターン、質問はまとめて — 尋問しないでください)。

    • ビジネス名+一行で事業内容;業種+顧客層。
    • 主な目的(電話/予約/登録/販売/作品展示)。
    • 言語 — デフォルトはチャット言語;バイリンガル(例:en + zh)を提案。
    • スコープ:単一ページ or 複数ページ? デフォルトは単一ページ。ユーザーがさらにページを希望する場合(またはブログに言及した場合)、標準セット(Home / About / Services / Blog / Contact)を提案し、ユーザーに取捨選択してもらいます — ページ一覧を確定してから構築に進みます。
    • 主なサービス・製品 3〜5 個;差別化ポイント;実際の数字;連絡先+主要な Call to Action。
    • 一言または二言で雰囲気(→ theme);アセット(ロゴ?ブランドカラー?実際の写真?)
    • ユーザーが簡潔だったり「適当にいい感じにして」と言った場合は、妥当なデフォルト(単一ページが安全なデフォルト)で進めてください。
  2. site.json の作成 references/site.schema.json に準拠すること。まず該当する例(単一ページなら innoe.site.json、複数ページなら multipage.site.json)を学習してください。実際の内容に合ったセクションをページあたり 5〜8 個選びます(references/sections.md の目標→セクションの対応表を参照)。

    • 単一ページ: すべてトップレベルの sections に配置。
    • 複数ページ: ホームはトップレベルの sections に;pages[] を追加(サブページごとに 1 エントリ、各エントリは独自の sections を持つ)。ナビゲーションはページから自動生成されます。ブログは posts セクションを持つページとして扱います(軽量:ヘッドラインカード、記事ページはなし)。 ルックを選択(references/theme.md 参照):ブランドに強い明確な美学がある場合はスタイル付きテンプレート(newchinese/cyber/portfolio)を選択するか、またはデフォルトとして template:"pro" を使用し、独自のパレットを自分でデザイン(primary/accent/neutral/font/radius/density)してください。各サイトが一点ものになります。画像はすべて references/assets.md に従って処理します。
  3. バリデーション。 validate.mjs を実行。失敗した場合はエラーを読み、JSON を修正し、再実行。無効なファイルで先に進まないでください。

  4. レンダリング。 render.mjs <site.json> <out-dir> を実行 → 静的サイトが <out-dir>/dist に生成されます。UNSPLASH_ACCESS_KEY が設定されている場合、レンダリングは自動的に unsplash プレースホルダーを実際の写真(クレジット付き)に置き換えます。設定がない場合はテーマ付きプレースホルダーがレンダリングされます — どちらでも出荷可能です。

  5. プレビューと反復。 構築した内容を平易な言葉で要約します(「5 ページのバイリンガルサイト:Home, About, Services, Journal, Contact」または「6 セクションの単一ページ」)。サイトは完全に編集可能であることをユーザーに伝えてください — いつでもページやセクションの追加・削除、コピーの書き換え、色の変更、ブログ記事の追加を依頼できます。編集は完全な site.json を再出力し、再バリデーション+再レンダリングによって適用します。

  6. デプロイ(ユーザーがプレビューを承認した後にのみ)。deploy.sh <out-dir> <domain> を実行 → Nginx + HTTPS で公開。公開 URL を報告します。

落とし穴

  • 出力はデータであり、コードではありません。 site.json のみを生成してください。HTML/CSS を手書きしてはいけません。
  • スキーマがルールです。 フィールド名と enum 値は正確に一致させてください。未知のフィールドは省略します。
  • アセットの捏造禁止。 Media の type:"placeholder"(装飾用)または "unsplash" と query(コンテンツ写真)を使用してください;"image" はユーザーから提供された実際の URL がある場合のみ使用します。ロゴは実際のロゴファイルがない限り、デフォルトで type:"text" とします。
  • 機能・サービスには画像よりアイコンを優先。 Lucide 名は常にレンダリングされ、色も変更できます。
  • すべての LocalizedText はサイトの全言語を保持します。 慣用的に翻訳し、空白のままにしないでください。
  • 作りすぎないでください。 5〜8 セクション。セクションの背景は交互に変更し、dark や primary が連続しないようにします。必ず hero で始め、cta または contact で閉じます。
  • コンプライアンスリスクのある主張は禁止 — ユーザーが明言していない認定、推薦、政府の補助金・助成金、賞、統計情報を捏造してはいけません。
  • 単一ページがデフォルトです。 ユーザーがリッチな/複数ページのサイトやブログを希望する場合にのみ pages[] を追加し、事前にページ一覧をユーザーと確認してください。ブログ(posts)はヘッドライン一覧であり、完全な記事ではありません。そのように伝え、記事は後から追加可能であることを伝えてください。

検証

  • validate.mjs が終了コード 0 で終了すること(解決されたセクション順序が表示されます)。
  • render.mjs が <out-dir>/dist/index.html を生成すること。
  • デプロイ後、curl -I https://<domain> が 200 を返すこと。

Individual skills in this repo

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

関連スキル