Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Veröffentlichen, bereitstellen oder vorbereiten einer fertigen statischen persönlichen Website, eines Blogs, Portfolios oder einer Stil-Neuerstellung für das Hosting auf GitHub Pages, Cloudflare Pages, Netlify oder Vercel. Verwende diesen Skill, wenn der Nutzer eine statische Site veröffentlichen, Deployment-Einstellungen konfigurieren, GitHub Pages-Workflows hinzufügen, eine statische Hosting-Plattform auswählen, ein Repo für Pages/Cloudflare/Netlify/Vercel vorbereiten, eine bereitgestellte URL überprüfen oder erklären möchte, wie ein Site-Ordner wie site/, dist/, out/, public/ oder docs/ deployed wird.

Was ist from-idea-to-personal-site?

Dieser Skill automatisiert das Deployment fertiger statischer Websites (HTML/CSS/JS) auf gängigen Plattformen wie GitHub Pages, Cloudflare Pages, Netlify und Vercel. Er erkennt das statische Ausgabeverzeichnis (z.B. site/, dist/, out/, public/, docs/), führt Vorabprüfungen durch (z.B. ob index.html existiert, Pfade korrekt sind, keine privaten Daten enthalten sind) und erstellt die notwendigen Konfigurationsdateien wie GitHub Actions-Workflows, netlify.toml oder vercel.json. Der Skill unterstützt verschiedene Bereitstellungsmodi: reine Beratung, Vorbereitung des Repos mit Konfigurationsdateien, Live-Deployment über Git oder Direkt-Upload und Überprüfung der Live-URL. Er arbeitet plattformspezifisch und vermeidet unnötige Framework-Einführungen. Sollten Anmeldeinformationen fehlen, liefert er genaue Dashboard-Schritte. Nach dem Deployment verifiziert er automatisch die Live-URL mit einem Browser-Tool oder über Playwright als Fallback.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/publish-static-site

In Ihrer bevorzugten KI fragen

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

Dokumentation

Statische Site veröffentlichen

Ziel

Eine fertige statische Website veröffentlichen oder für das Deployment vorbereiten.

Dieser Skill ist für einsetzbare HTML/CSS/JS-Ausgaben wie site/, dist/, out/, public/ oder docs/. Er kann auch Framework-Projekte veröffentlichen, nachdem diese einen statischen Ausgabeordner erzeugt haben, soll aber eine reine statische Site nicht in ein Framework-Projekt umwandeln, nur um sie zu deployen.

Standardhaltung:

  • Einfaches statisches Hosting gegenüber frameworkspezifischem Deployment bevorzugen.
  • Git-basiertes Deployment für Websites bevorzugen, die der Nutzer weiter bearbeiten wird.
  • Direkten Upload nur für schnelle einmalige Veröffentlichungen bevorzugen.
  • Keine Remote-Repositories erstellen, Code pushen, DNS ändern, Domains hinzufügen oder in einen kostenpflichtigen Account deployen, es sei denn, der Nutzer fordert dies ausdrücklich.

Vertrag

Eingaben:

  • Statisches Deploy-Root wie site/, dist/, out/, public/, docs/ oder Repository-Root.
  • Bevorzugte Plattform oder Ziel: GitHub Pages, Cloudflare Pages, Netlify, Vercel, benutzerdefinierte Domain, nur Beratung oder Live-Deployment.
  • Aktueller Git-/Repository-Status, Plattformzugriff, CLI-/Browser-Login und etwaige Deployment-Einschränkungen.

Ausgaben:

  • Konkrete Deployment-Einstellungen: Plattform, Branch, Build-Befehl, Basisverzeichnis, Publikations-/Ausgabeverzeichnis und ggf. Konfigurationsdateien.
  • Optionale plattformspezifische Konfiguration wie GitHub Pages-Workflow, netlify.toml, vercel.json, .nojekyll oder CNAME.
  • Live-URL und Überprüfung nach dem Deployment, wenn das Deployment tatsächlich durchgeführt wird.
  • Manuelle Dashboard-Schritte, wenn Anmeldeinformationen oder Accountzugriff nicht verfügbar sind.

Grenzen:

  • Die Site nicht erstellen oder umgestalten; Fehler an den entsprechenden Unter-Skill weiterleiten.
  • Nicht pushen, Repos/Projekte erstellen, hochladen, Domains binden, DNS ändern oder kostenpflichtige Ressourcen nutzen, es sei denn, dies wurde ausdrücklich autorisiert.
  • Deployment nicht als Workaround für defekte lokale/statische Pfadkompatibilität verwenden, es sei denn, der Nutzer akzeptiert explizit ein Server-Root-only-Verhalten.

Erfolgskriterium:

  • review-static-site wurde bestanden oder ungelöste Risiken sind explizit.
  • Das Deploy-Root enthält index.html und die Plattform wird den korrekten Ordner veröffentlichen.
  • Online-URL lädt die Startseite, Assets, Navigation und repräsentative Unterseiten nach dem Deployment.

Bei Fehlschlag des Kriteriums:

  • Pfad-, Asset-, Kodierungs- oder Seitentyp-Blocker vor dem Deployment beheben.
  • Inhalt-/Design-/Import-Probleme an personalize-site, edit-site-part, add-blog-posts, make-personal-site oder copy-website-style weiterleiten.
  • review-static-site erneut ausführen und dann Deployment-Einstellungen erneut versuchen oder aktualisieren.

Referenzen

Nur die für die gewählte Plattform oder das Problem benötigte Referenz laden:

  • Pfadstrategie und Direkt-Öffnen-Kompatibilität: references/path-strategy.md.
  • Cloudflare Pages Git-Integration und Direkt-Upload: references/cloudflare-pages.md.
  • GitHub Pages Branch-Quelle und Actions-Workflows: references/github-pages.md.
  • Netlify-Dashboard und netlify.toml: references/netlify.md.
  • Vercel-Dashboard und vercel.json: references/vercel.md.

Offizielle Dokumentation:

Deployment-Modi

Zunächst ermitteln, was der Nutzer tatsächlich möchte:

  • Nur Beratung: Plattformwahl und genaue Einstellungen erklären. Dateien nur bearbeiten, wenn es sinnvoll ist.
  • Repo vorbereiten: Die benötigten Konfigurationsdateien hinzufügen und dem Nutzer mitteilen, worauf er im Hosting-Dashboard klicken muss.
  • Jetzt deployen: Remote-Aktionen nur durchführen, wenn der Nutzer dies ausdrücklich verlangt hat und die erforderliche CLI/Auth/Session vorhanden ist.
  • Live-URL überprüfen: Die bereitgestellte URL in einem Browser öffnen und mit der lokalen Site vergleichen.

Wenn Anmeldeinformationen, Accountzugriff, Browser-Login oder CLI-Authentifizierung fehlen, genaue Dashboard-Schritte angeben, anstatt einen Workaround zu erfinden.

Arbeitsablauf

  1. Den statischen Ausgabeordner und die bevorzugte Plattform des Nutzers identifizieren, falls vorhanden.
  2. review-static-site vor der Veröffentlichung aufrufen oder vorschlagen.
  3. Bestätigen, dass das Deploy-Root index.html enthält.
  4. Asset-Pfade inspizieren und versehentliche root-absolute site-lokale Pfade vor der Veröffentlichung konvertieren. references/path-strategy.md laden, wenn das Pfadverhalten unklar ist.
  5. Die einfachste passende Plattform und den einfachsten Deployment-Modus wählen.
  6. Die gewählte Plattformreferenz laden und nur die von dieser Plattform benötigten Konfigurationsdateien hinzufügen.
  7. Bei Deployment über Git den Git-Status prüfen und vermeiden, nicht zusammenhängende oder private Dateien einzuschließen.
  8. Wenn der Nutzer Remote-Aktionen autorisiert hat, genau das pushen oder deployen, was vereinbart wurde.
  9. Nach der Veröffentlichung die Live-URL öffnen und die bereitgestellte Site in einem Browser überprüfen.

Preflight-Checkliste

Diese Prüfungen durchführen, bevor Deployment-Konfigurationen geschrieben oder dem Nutzer Einstellungen mitgeteilt werden:

  • Deploy-Root: Den Ordner wählen, der direkt index.html enthält.
  • Einstiegsseite: index.html muss auf der obersten Ebene des Deploy-Root existieren.
  • Direkt-Öffnen-Vorschau: Das Root-index.html sollte CSS, JS, Bilder und Navigation behalten, wenn es direkt aus dem Dateisystem geöffnet wird, es sei denn, der Nutzer hat explizit ein Server-Only-Verhalten akzeptiert.
  • Lokaler HTTP: Das Deploy-Root mit python -m http.server bereitstellen und bestätigen, dass es über http://127.0.0.1:<port>/ funktioniert.
  • Statisches Audit: review-static-site für Links, UTF-8-Lesbarkeit, Platzhalterreste, Browser-Rendering, Datenschutzreste und mobiles Layout ausführen oder empfehlen.
  • Asset-Pfade: href, src, srcset, CSS url(...), Schriftarten, Favicons, Coverbilder, RSS, Sitemap und Manifest-Links inspizieren.
  • Private Daten: Sicherstellen, dass Tokens, lokale Dateisystempfade, Entwurfsnotizen, Quell-Site-Identitäten und persönliche Geheimnisse nicht veröffentlicht werden.
  • Ausgabe-Vollständigkeit: Bestätigen, dass Unterseiten, Beiträge, Bilder, Herstellerschriftarten, KaTeX/Mathe-Assets und kopierte Medien innerhalb des Deploy-Root liegen.

Diese als Blockade behandeln:

  • Kein index.html im Deploy-Root.
  • Defekte lokale CSS-, JS-, Bild-, Schriftart-, RSS-, Sitemap- oder Hersteller-Asset-Pfade.
  • Quelldateien enthalten Mojibake oder unlesbare Kodierung.
  • Die generierte persönliche Site enthält noch kopierte Quell-Identität, die hätte ersetzt werden sollen.
  • Versehentliche root-absolute site-lokale Pfade wie /assets/..., /posts/..., /data/... oder /images/... sind noch in einer generierten rein statischen Site vorhanden.
  • Die Site funktioniert nur über lokales HTTP, weil root-absolute Pfade von 127.0.0.1 bereitgestellt werden, aber direktes Dateiöffnen oder Subpfad-Deployment würde CSS/JS/Bilder verlieren.
  • Datenschutzsensible Dateien oder Geheimnisse würden deployed.
  • Die Plattform würde den falschen Ordner deployen.

Plattformwahl

Diese Standard-Reihenfolge für einfache statische persönliche Websites verwenden:

  1. Cloudflare Pages Git-Integration: Bester Standard für einen generierten site/-Ordner und zukünftige Updates.
  2. GitHub Pages mit GitHub Actions: Am besten, wenn der Nutzer alles innerhalb von GitHub haben möchte.
  3. Netlify: Einfaches statisches Hosting mit benutzerfreundlichen Vorschauen und Dashboard-Einstellungen.
  4. Vercel: Gut, wenn der Nutzer bereits Vercel verwendet oder später zu Next.js wechseln möchte, aber nicht der Standard für reines HTML.

Entscheidungsregeln:

  • Wenn der Nutzer die geringste Reibung möchte und ein GitHub-Repo hat: Cloudflare Pages Git-Integration. references/cloudflare-pages.md laden.
  • Wenn der Nutzer reines GitHub-Hosting möchte: GitHub Pages. references/github-pages.md laden.
  • Wenn Deploy-Dateien im Repository-Root oder unter /docs leben: GitHub Pages Branch-Quelle ist akzeptabel.
  • Wenn Deploy-Dateien in site/, dist/, out/ oder einem anderen benutzerdefinierten Ordner leben: GitHub Actions für GitHub Pages bevorzugen.
  • Wenn der Nutzer heute manuell hochladen möchte: Cloudflare Direct Upload oder Netlify manuelles Deployment.
  • Wenn der Nutzer bereits einen Vercel-Account/ein Vercel-Projekt hat: Vercel mit expliziten Ausgabeverzeichniseinstellungen verwenden.

Framework-Statische Ausgabe

Wenn die Site nicht reines HTML/CSS/JS ist:

  • package.json, Framework-Konfiguration und vorhandene Skripte inspizieren.
  • Den vorhandenen Build-Befehl des Projekts verwenden; keine npm-Workflows erfinden.
  • Den endgültigen statischen Ausgabeordner veröffentlichen, nicht den Quellordner.
  • Häufige Ausgaben umfassen dist, out, build, .output/public und public, je nach Framework.
  • Für Next.js Static Export sicherstellen, dass das Projekt tatsächlich für Static Export konfiguriert ist, bevor out/ als endgültige Ausgabe behandelt wird.
  • Für Vue/Vite/Astro-Projekte das konfigurierte Ausgabeverzeichnis nach einem erfolgreichen Build veröffentlichen.

Wenn der Nutzer reines statisches Publishing angefordert hat und keine Framework-Dateien vorhanden sind, kein npm einführen.

Konfigurationsdatei-Richtlinie

Nur Konfigurationsdateien hinzufügen, die zur gewählten Plattform passen:

  • GitHub Pages Actions: .github/workflows/pages.yml.
  • GitHub Pages benutzerdefinierte Domain: CNAME im Deploy-Root, nur wenn der Nutzer die Domain angegeben hat.
  • GitHub Pages Jekyll-Umgehung: .nojekyll im Deploy-Root, wenn nützlich.
  • Netlify: netlify.toml nur, wenn Dashboard-Einstellungen nicht ausreichen oder der Nutzer die Konfiguration in Git haben möchte.
  • Vercel: vercel.json nur, wenn Vercel explizite Ausgabeeinstellungen benötigt.
  • Cloudflare Pages: Dashboard-Einstellungen reichen normalerweise für reine statische Websites aus.

Keine Deployment-Konfigurationen für jede Plattform auf einmal hinzufügen.

Git- und Remote-Sicherheit

Vor jeder Remote-Aktion angeben, was passieren wird, und bestätigen, dass der Nutzer dies angefordert hat:

  • Ein GitHub-Repository erstellen.
  • Ein Remote hinzufügen.
  • Dateien stagen oder committen.
  • Commits in einen Remote-Branch pushen.
  • GitHub Pages aktivieren.
  • Cloudflare-, Netlify- oder Vercel-Projekte erstellen.
  • Dateien zu einem Hosting-Anbieter hochladen.
  • Umgebungsvariablen hinzufügen.
  • Benutzerdefinierte Domains hinzufügen oder DNS-Einträge ändern.

Vor dem Stagen oder Pushen:

  • git status --short ausführen.
  • Generierte Site-Dateien von nicht zusammenhängenden Benutzeränderungen unterscheiden.
  • Nicht zusammenhängende Änderungen nicht stagen.
  • Keine privaten Notizen, Anmeldeinformationen, lokalen Pfade, Screenshots mit Geheimnissen oder temporären Dateien veröffentlichen.

Niemals Geheimnisse, Tokens, private Notizen oder lokale Dateisystempfade in die statische Site oder Deployment-Konfiguration einfügen.

Post-Deployment-Überprüfung

Nachdem die Plattform eine Live-URL gemeldet hat:

  • Die bereitgestellte URL mit einem tatsächlich verfügbaren interaktiven Browser-Tool öffnen. „Verfügbar“ bedeutet, dass es in der aktuellen Runde in der aufrufbaren Werkzeugliste verfügbar ist. In Codex kann dies das Browser-/In-App-Browser-Plugin sein, wenn es in die Runde geroutet wurde.
  • Überprüfen, dass die Startseite kein 404, eine leere Seite oder eine Verzeichnisliste ist.
  • Überprüfen, dass CSS, JavaScript, Bilder, Schriftarten, Favicon, RSS, Sitemap und Hersteller-Assets von der bereitgestellten Domain geladen werden.
  • Die primäre Navigation und mindestens eine repräsentative Unterseite pro Seitentyp anklicken.
  • Desktop- und Mobilbreiten testen.
  • Die Browser-Konsole auf fehlende Assets oder JavaScript-Fehler prüfen.
  • Metadaten, Titel, Beschreibung, Open-Graph-Bild, kanonische URL, RSS, Sitemap und Robots-Dateien überprüfen, wenn vorhanden.
  • Bei Verwendung von GitHub Project Pages speziell Unterseiten und Asset-URLs unter dem Repository-Subpfad überprüfen.
  • Bei Verwendung einer benutzerdefinierten Domain HTTPS und Weiterleitungen zwischen Apex und www überprüfen, falls konfiguriert.

Wenn kein interaktives Browser-Tool aufrufbar ist, nicht vorgeben, dass eine Live-Browser-Überprüfung stattgefunden hat. Den Nutzer bitten, das Browser-Tool zu aktivieren oder aufzurufen, wenn eine visuelle Live-Überprüfung wichtig ist; für Codex kann dies bedeuten, eine Anfrage zu senden, die explizit @browser erwähnt. Wenn der Nutzer nicht umleitet oder der Client kein solches Tool hat, auf Playwright, Screenshots, HTTP-Prüfungen oder statische Prüfungen zurückfallen und die Einschränkung angeben.

Nicht standardmäßig nur Playwright oder Screenshots für die Live-Überprüfung verwenden, wenn ein interaktives Browser-Tool tatsächlich aufrufbar ist. Playwright nur als Fallback verwenden, oder wenn der Nutzer ausdrücklich skriptgesteuerte Deployment-Prüfungen anfordert.

Wenn die bereitgestellte Site von der lokalen Vorschau abweicht, das Deployment-Log, das Ausgabeverzeichnis und die Asset-Pfadstrategie inspizieren, bevor der Design-Code geändert wird.

Ausgabe

Die abschließende benutzerorientierte Zusammenfassung präzise halten:

  • Gewählte Plattform und warum.
  • Veröffentlichter oder vorbereiteter statischer Ordner.
  • Deployment-Modus: Beratung, vorbereitete Konfiguration, Git-Integration, Direkt-Upload oder Live-Deployment.
  • Verwendete Einstellungen: Branch, Build-Befehl, Basisverzeichnis, Publikations-/Ausgabeverzeichnis.
  • Geänderte Konfigurationsdateien, falls vorhanden.
  • Offizielle Anleitungs-URL für die gewählte Plattform.
  • Live-URL, falls ein Deployment stattfand.
  • Durchgeführte Überprüfung und verbleibende manuelle Schritte.

Wenn nur eine Beratung angefordert wurde, nicht vorgeben, dass die Site deployed wurde. Konkrete Plattformeinstellungen und Links zu offiziellen Anleitungen angeben.

Individual skills in this repo

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

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

Verwandte Skills