Communitygithub.com

umairmsm/wp-design

WordPressビルドのStage 2:デザイン方向性の決定、デザイントークンを用いた静的HTML/CSSプロトタイプの作成、オーナー承認の取得(スクリーンショット使用)、セルフホストフォントへの対応、承認されたルックを差し替え可能なWordPressスキンに移植します。「サイトをデザイン」「新しい外観」「リデザイン」「色やフォントを変更」「新しいスキンを作成」「プロトタイプをWordPressに移植」といった作業に使用します。

wp-design とは?

このスキル(umairmsm/wp-design)は、WordPressサイト構築プロセスにおける第2段階「デザイン」を自動化・構造化するためのAIエージェントスキルです。主な目的は、クライアント(オーナー)がスマートフォンとラップトップ上で承認したデザインルックを、デザイントークンとして文書化し、後から機能を失うことなく差し替え可能なWordPressスキンとして移植することです。具体的には、まずプロジェクト内にデザイン方向性を定義するドキュメント(DESIGN_DIRECTION.md)を作成し、次に静的HTML/CSSプロトタイプを`static/`ディレクトリに構築します。プロトタイプではアクセシビリティ(コントラスト比4.5:1以上、フォーカス表示、スキップリンク、キーボード操作、動きの抑制対応)を最初から考慮し、axeツールでチェックします。その後、全てのページのスクリーンショット(375px、1440px幅)を取得してオーナー承認を得ます。フォントはセルフホスト(.woff2)し、必要な言語のみにサブセット化、Google Fontsへのリクエストは一切行いません。最後に、承認されたデザインをWordPressスキンとして`skins/`ディレクトリにコピーし、デザイントークンをスキンに反映、コンポーネントCSSを`skin.css`に移動、テンプレートはコアのレンダリング関数を使用してレイアウトします。これにより、デザインの変更はスキンの切り替えで実現でき、コアのデータやマークアップ契約は変更されません。このスキルはClaude Code、Cursor、CodexなどのAIエージェント向けに設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umairmsm/wp-site-kit/tree/HEAD/skills/wp-design

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

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

ドキュメント

ステージ2: デザイン

目標: オーナーがスマートフォンとラップトップで確認し承認したルックを得ること。そのルックはトークンとして記述され、コピーによってWordPressスキンにでき、後で機能を失うことなく置き換えられます。

ステップ

  1. 方向性の決定。 プロジェクトの docs/DESIGN_DIRECTION.md を記入:北極星、ターゲットオーディエンス、似てはいけないもの(競合、テンプレート)、および譲れない条件。方向性は最大2~3つ提示し、小さなムードボードまたはヒーローモックアップとして提示します(フルサイトは不要)。
  2. static/ でのプロトタイプ作成。 プレーンなHTMLとCSSを使用。css/tokens.css はテーマの skins/default/tokens.css と同じ名前を使用します。コンポーネントはトークンのみを使用。実際の構造(ヘッダー、ヒーロー、カード、フォーム、フッター)、プレースホルダーのコピー、価格やポリシーテキストは含めません。
  3. アクセシビリティを最初から考慮:
    • テキストのコントラスト比は4.5:1以上;
    • フォーカスが可視であること;
    • H1は1つ;
    • スキップリンク;
    • キーボード操作経路;
    • prefers-reduced-motion に対応。 表示前にaxe(ブラウザ拡張機能)でプロトタイプをチェックします。
  4. オーナーレビュー。 すべてのページについて、スマートフォン幅(375px)とラップトップ幅(1440px)のスクリーンショットを撮影。承認日を DESIGN_DIRECTION.md に記録し、スクリーンショットを docs/design/ に保存します。
  5. フォント: .woff2 ファイルをセルフホストし、必要な言語にサブセット化し、ライセンスを確認し、最初の画面に表示される1~2種類のフェイスをプリロードします(ファイル名は *-preload.woff2 とします)。Google Fontsへのリクエストは一切行いません。
  6. WordPressへの移植(references/design-system.md):
    • トークンをスキンにコピー;
    • コンポーネントCSSを skin.css に移動;
    • コアのレンダリング関数を使用してテンプレートをレイアウト;
    • マークアップが異なる必要がある場合にのみ、スキンパーツのオーバーライドを追加。 見た目は変わりますが、コアのデータとマークアップの契約は変わりません。
  7. その後のリデザイン は新しいスキンとして行います:skins/default を skins/<名前> にコピーし、トークンを変更し、?skin=<名前> でプレビュー(管理者のみ)、承認後に <プレフィックス>_skin オプションで切り替えます。

ゲート(SITE_STATUS.md でチェック)

  • DESIGN_DIRECTION.md 作成済み;スクリーンショット付きのオーナー承認を記録済み
  • トークンが定義済み;コンポーネントはトークンのみを使用
  • フォントはセルフホスト済み;Google Fontsへのリクエスト0

教訓

  • ロックされたデザインは、ビジネスパートナーが独自のリデザインを送ってきたときに変更されました。ルックがスキンであったため、切り替えによってすべての機能が維持されました。最初のデザインも含め、すべてのデザインをスキンとして構築しましょう。
  • 競合のパレット、タイプペアリング、レイアウトをコピーしないでください。オーナーは気づきますし、訪問者はあなたを覚えてくれません。
  • アイデアを試すためのテスト専用スキン(dev-*)は、本番環境では決して表示されません。
  • frontend-design または design-motion-principles スキルがインストールされている場合、方向性とモーションにそれらを使用します。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

umairmsm/wp-build

Stage 3 of a wp-site-kit WordPress build - local DDEV site, the core must-use plugin (modules), the presentation-only child theme with skins, the content model (custom post types, meta, WP_Query, render functions), and the enquiry pipeline that saves leads before forwarding. Use when building or changing features, templates, content types, forms or plugin modules on a wp-site-kit site.

umairmsm/wp-content

Stage 4 of a wp-site-kit WordPress build - real copy and photos. Content truth (facts only from the owner), AI drafts and owner approval, claims audits, banned words and fake proof, legal pages, the photo pipeline (dedupe, real-only, EXIF strip, WebP sizes, alt text, AI image register), and recorded content changes. Use for "write the copy", "add photos", "the owner sent new photos", "check for duplicates", "update prices or text on the live site", "legal pages".

umairmsm/wp-kickoff

Stage 1 of a wp-site-kit WordPress build. Use when starting a new WordPress website or taking over or rebuilding an existing one - discovery brief, stack decision, creating the project with bin/wp-site-new, locked decisions, private repo and credentials inventory. Triggers - "new WordPress site", "start a client website", "rebuild this site", "take over this WordPress site".

umairmsm/wp-operate

Stage 8 of a wp-site-kit WordPress build and everything after launch - backups with an off-machine copy, restore drills, the disaster-recovery runbook, credentials inventory, update policy, alerts, and working from more than one machine (bridge file, workstation doctor, encrypted state bundle, rescuing unpushed work). Use for "backup", "restore", "move to a new machine/server", "update plugins", "what if the server dies", "work from the cloud box", "set up a second machine".

umairmsm/wp-seo

Stage 5 of a wp-site-kit WordPress build - titles and descriptions, canonical URLs, one schema owner and JSON-LD, sitemaps, robots.txt and llms.txt, AI crawler access, redirects (301 vs 302), legacy URL maps, Search Console, and adding languages one pilot at a time with Polylang (hreflang, .po/.mo strings, native review). Use for "SEO", "schema", "redirect", "old URLs", "translate the site", "add French/Spanish", "hreflang", "canonical".

umairmsm/wp-ship

Stage 7 of a wp-site-kit WordPress build - staging behind Cloudflare Access, server hardening, safe deploys from a commit (scripts/deploy-safe.sh), database content changes, the launch audit, DNS cutover without breaking a running business, and the first week after launch. Use for "deploy", "set up staging", "go live", "launch", "cutover", "move DNS", "harden the server".

umairmsm/wp-site

Start here for any WordPress website built with wp-site-kit, from an empty folder to a live site. Use when someone says "build a WordPress site", "new website for a client", "where are we on the site", "what is next before launch", or asks to continue a site project. Finds the current stage from SITE_STATUS.md, applies the hard rules, and hands over to the right stage skill.

関連スキル