Communitygithub.com

umairmsm/wp-design

Phase 2 eines wp-site-kit WordPress-Builds – Designrichtung, statischer HTML/CSS-Prototyp mit Design-Tokens, Owner-Abnahme mit Screenshots, selbst gehostete Schriftarten und Übertragung des freigegebenen Looks in eine austauschbare WordPress-Skin.

Was ist wp-design?

Dieses Skill definiert die zweite Phase eines WordPress-Projekts, bei dem das visuelle Design festgelegt und in eine austauschbare Skin überführt wird. Es führt den Entwickler durch einen strukturierten Prozess: Ausarbeitung einer Designrichtung, Erstellung eines statischen HTML/CSS-Prototyps mit Design-Tokens, Sicherstellung der Barrierefreiheit von Anfang an, Owner-Abnahme mit Screenshots auf verschiedenen Bildschirmgrößen, Selbsthosting von Schriftarten ohne Google Fonts und schließlich die Übertragung des freigegebenen Looks in eine WordPress-Skin. Der große Vorteil liegt in der Trennung von Aussehen und Funktionalität: Durch die Verwendung von Design-Tokens und einer Skin-Architektur kann das Design später problemlos ausgetauscht werden, ohne die darunterliegenden Funktionen zu beeinträchtigen. Das Skill unterstützt beliebige WordPress-Setups, die der `wp-site-kit`-Struktur folgen, und enthält klare Prüfkriterien sowie Lessons Learned zu typischen Fallstricken wie dem Kopieren von Wettbewerbern oder der Verwendung von Google Fonts. Es interagiert eng mit den Skills `frontend-design` und `design-motion-principles`, falls diese installiert sind.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Phase 2: Design

Ziel: Der Owner hat einen Look freigegeben, den er auf einem Telefon und einem Laptop gesehen hat. Er ist als Tokens dokumentiert, sodass er durch Kopieren in eine WordPress-Skin umgewandelt und später ersetzt werden kann, ohne Funktionen zu verlieren.

Schritte

  1. Richtung. Befülle docs/DESIGN_DIRECTION.md des Projekts: Leitstern, Zielgruppe, wie wir nicht aussehen dürfen (Wettbewerber, Templates) und die unverhandelbaren Anforderungen. Biete höchstens zwei oder drei Richtungen an, als kleine Moodboards oder Hero-Mockups, nicht als vollständige Websites.
  2. Prototyp in static/. Reines HTML und CSS. css/tokens.css verwendet dieselben Namen wie die skins/default/tokens.css des Themes. Komponenten nutzen ausschließlich Tokens. Echte Struktur (Header, Hero, Karten, Formular, Footer), Platzhaltertexte, keine Preise und keine Rechtstexte.
  3. Barrierefreiheit von Anfang an:
    • Kontrast ≥ 4,5:1 für Text;
    • sichtbarer Fokus;
    • eine H1;
    • ein Skip-Link;
    • Tastaturnavigation;
    • prefers-reduced-motion wird respektiert. Überprüfe den Prototyp mit axe (Browsererweiterung), bevor du ihn zeigst.
  4. Owner-Review. Screenshots jeder Seite bei Telefonbreite (375 px) und Laptopbreite (1440 px). Halte das Freigabedatum in DESIGN_DIRECTION.md fest und speichere die Screenshots in docs/design/.
  5. Schriftarten: Selbst hosten als .woff2-Dateien, auf die benötigten Sprachen beschränken, die Lizenz prüfen und die ein oder zwei Schriftarten für den ersten Bildschirm vorladen (benenne sie *-preload.woff2). Keine Google Fonts-Anfragen irgendwo.
  6. Übertragung nach WordPress (references/design-system.md):
    • Kopiere die Tokens in die Skin;
    • Verschiebe das Komponenten-CSS in skin.css;
    • Lege Templates mit den Render-Funktionen des Cores an;
    • Füge Skin-Part-Überschreibungen nur dort hinzu, wo das Markup abweichen muss. Das Aussehen ändert sich; die Daten- und Markup-Verträge des Cores bleiben bestehen.
  7. Spätere Neugestaltungen sind neue Skins: Kopiere skins/default nach skins/<name>, ändere Tokens, Vorschau mit ?skin=<name> (Admins) und Umschaltung über die Option <prefix>_skin nach Freigabe.

Tor (abgehakt in SITE_STATUS.md)

  • DESIGN_DIRECTION.md geschrieben; Owner-Freigabe mit Screenshots dokumentiert
  • Tokens definiert; Komponenten verwenden ausschließlich Tokens
  • Schriftarten selbst gehostet; 0 Anfragen an Google Fonts

Lektionen

  • Das festgelegte Design änderte sich, als der Geschäftspartner seinen eigenen Redesign-Entwurf einreichte. Da der Look eine Skin war, blieb beim Wechsel jedes Feature erhalten. Baue jedes Design als Skin, selbst das erste.
  • Kopiere nicht die Farbpalette, Schriftkombination oder das Layout eines Wettbewerbers. Owners bemerken es, und Besucher erinnern sich nicht an dich.
  • Eine reine Test-Skin (dev-*) zum Ausprobieren von Ideen erscheint nie auf der Produktionsseite.
  • Falls die Skills frontend-design oder design-motion-principles installiert sind, verwende sie für Richtung und Bewegung.

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.

Verwandte Skills