Communitygithub.com

wordpress-theme-build

静的なHTML/CSS/JSデザインを、クライアントが編集可能なカスタムWordPressテーマに変換します。テーマ構造、theme.json、スクリプトのキューイング、ブロックパターン、カスタム投稿タイプ、編集可能なコンテンツをカバー。デザインや静的サイトをWordPressに変換したいとき、カスタムテーマやブロックテーマを構築したいとき、Gutenbergでセクションを編集可能にしたいとき、GSAPなどのスクリプトを適切にテーマに追加したいとき、テーマの編集が失われたりコンテンツがハードコードされたりする理由を尋ねられたときに使用します。

wordpress-theme-build とは?

このスキルは、静的なHTML/CSS/JSデザインをクライアントが編集可能なWordPressテーマに変換するための包括的なガイドです。デザインをコードに固定しつつ、コンテンツはエディタで編集可能にすることを目標とし、ハードコードされたテキストによる後戻りを防ぎます。ブロックテーマ、ハイブリッドクラシックテーマ、子テーマという3つのアプローチからプロジェクトに最適な方法を選択でき、特にアニメーションや複雑なマークアップが必要なサイトにはハイブリッドアプローチが推奨されています。変換ワークフローは8つのステップで構成され、静的ビルドの凍結、パーツ分割、theme.jsonへのトークン移行、アセットの適切なキューイング、コンテンツの編集可能化、エスケープ処理、画像管理、テーマサポートの設定をカバーします。また、WordPress内でのアニメーション実装に関する注意点(エディタでのスクリプト実行回避、管理バーのオフセット、キャッシュプラグインとの互換性、エディタ追加コンテンツへのアニメーション適用)や、避けるべきプラクティス(コアや親テーマの編集、テーマ依存の機能実装、ループ内でのリセット忘れなど)も詳しく解説しています。対応プラットフォームはWordPress(ブロックテーマ、ハイブリッドクラシックテーマ、子テーマ)で、Claude CodeやCursor、CodexなどのAIエージェントで活用できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/wordpress-theme-build

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

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

ドキュメント

WordPressテーマビルド

目標は、デザインはコードに固定し、コンテンツはエディタで編集可能なテーマを作成することです。テンプレート内のハードコードされたテキストは、クライアントが些細な編集で戻ってくる最も一般的な理由です。

アプローチの選択

アプローチ選択するタイミング
ブロックテーマ(theme.json、HTMLテンプレート)新規ビルド、クライアントがサイトエディタで編集、コンテンツが主に標準ブロック
ハイブリッドクラシックテーマ(PHPテンプレート+theme.jsonとブロックパターン)正確なHTML制御が必要な複雑なカスタムマークアップや重いアニメーション
子テーマ既存テーマの変更;親テーマを直接編集しないでください。アップデートで上書きされるため

アニメーションを使ったデザイン主導のマーケティングサイトの場合、ハイブリッドアプローチが通常は実用的です。PHPで正確なマークアップを記述し、パターン、フィールド、ブロックエディタを通じてコンテンツを編集可能にします。

最小構成

my-theme/
├── style.css            # テーマヘッダーコメント(必須)
├── functions.php        # セットアップ、エンキュー、登録
├── theme.json           # パレット、タイプスケール、スペーシング、レイアウト幅
├── index.php            # フォールバックテンプレート(クラシック/ハイブリッド)
├── front-page.php       # ホームページ
├── header.php  footer.php
├── template-parts/      # セクションごとに1ファイル
├── patterns/            # ブロックパターン(自動登録)
├── assets/css  assets/js  assets/media
└── screenshot.png       # 1200x900

style.cssヘッダー:

/*
Theme Name: My Theme
Author: Your Name
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: my-theme
*/

変換ワークフロー

  1. 静的ビルドを凍結する。 最初にHTML、CSS、JSを完成させて検証します。動くターゲットを変換すると作業が2倍になります。
  2. パーツに分割する。 ヘッダーとフッターはheader.phpとfooter.phpにwp_head()とwp_footer()を入れて配置します。ホームページの各セクションはtemplate-parts/内のファイルになり、get_template_part()で読み込みます。
  3. トークンをtheme.jsonに移動する(パレット、フォントサイズ、スペーシング、コンテンツ幅)。エディタにフロントエンドと同じ選択肢が表示されるようにします。CSSカスタムプロパティと同じ値を保持します。WordPressは--wp--preset--*変数を生成するため、エイリアスとして使用できます。webcraft CLIが利用可能な場合、webcraft tokens "#brand" --format theme-json -o theme.json はtokens.cssと同じ値からバージョン3ファイルを書き出します。
  4. アセットはハードコードせずにエンキューする:
add_action('wp_enqueue_scripts', function () {
    $v = wp_get_theme()->get('Version');
    $uri = get_theme_file_uri('assets');
    wp_enqueue_style('my-theme', "$uri/css/main.css", [], $v);
    wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
    wp_enqueue_script('my-theme', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});

ライブラリは可能な限りCDNではなくローカルにバンドルします。サードパーティのリクエストと同意の問題を回避できます。 5. コンテンツを編集可能にする。 セクションごとに選択:

  • 独自ページを持つ繰り返しアイテム(サービス、ポートフォリオ、お客様の声):WP_Queryでクエリするカスタム投稿タイプ。
  • 1回限りのセクションテキストと画像:クライアントが挿入して編集するブロックパターン、またはカスタムフィールド。
  • グローバルアイテム(電話、ソーシャルリンク、フッターテキスト):カスタマイザーまたは小さなオプションページ。
  • ナビゲーション:register_nav_menus() と wp_nav_menu()。
  1. 出力時にすべてをエスケープする: esc_html()、esc_attr()、esc_url()、リッチテキストにはwp_kses_post()。文字列をテキストドメイン付きの__() または esc_html__() でラップします。
  2. 画像: wp_get_attachment_image() を使用して、srcset、sizes、寸法、遅延読み込みが生成されるようにします。必要なサイズはadd_image_size()で登録します。
  3. テーマサポート: title-tag、post-thumbnails、editor-styles、responsive-embeds、html5、wp-block-styles。

WordPress内でのアニメーション

  • コンテンツを非表示にするスクリプトはブロックエディタで実行してはいけません。フロントエンドでのみエンキューします(enqueue_block_assets ではなく wp_enqueue_scripts)。
  • 管理バーはスティッキーヘッダーを32px(モバイルでは46px)シフトします。body.admin-bar .header { top: var(--wp-admin--admin-bar--height, 32px); } でオフセットします。
  • JSを遅延実行または結合するキャッシュ・最適化プラグインはロード順序を壊す可能性があります。依存関係を適切に宣言して尊重されるようにし、プラグインを有効にしてテストします。
  • エディタで追加されたコンテンツにはアニメーション属性がありません。ブロッククラスごとにJSでアニメーションを適用するか、属性を含むパターンを提供します。

禁止事項

  • WordPressコアまたは親テーマを編集しないでください。
  • テーマを切り替えても残るべき機能(カスタム投稿タイプ、ショートコード)を、クライアントがテーマを変更する可能性がある場合にテーマに入れないでください。小さなプラグインが適切な場所です。
  • ループ内でリセットせずにクエリを行わないでください(wp_reset_postdata())。
  • WP_DEBUG 通知を出して出荷しないでください。WP_DEBUG をオンにして開発してください。
  • 再配布を許可しないライセンスの有料プラグインやアセットをバンドルしないでください。

引き継ぎチェックリスト

  • クライアントがコードに触れずにすべての表示テキスト、画像、メニュー項目、連絡先詳細を変更できる。
  • ホームページが設定→表示設定で設定され、パーマリンクが「投稿名」に設定されている。
  • ファビコン(サイトアイコン)、404テンプレート、検索テンプレート、プライバシーページが存在する。
  • スクリーンショット付きの1ページ編集ガイド。
  • その後、launch-qa スキルを実行します。

Individual skills in this repo

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

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

関連スキル