Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Nutze diesen Skill für gezielte, kleinskalige Änderungen an einer generierten statischen Website, einem persönlichen Blog, Portfolio, Digital Garden oder einer Design-Neukreation. Verwende ihn, wenn der Benutzer einen Seitenabschnitt, eine Komponente, ein visuelles Detail, einen Textblock, ein Responsive-Problem oder eine kleine Interaktion anpassen möchte, ohne die gesamte Seite neu zu erstellen.

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

Dieser Skill namens „Edit Site Part“ (Seitenteil bearbeiten) ermöglicht es einem KI-Agenten (z. B. Claude Code, Cursor, Codex), punktuelle Änderungen an einer bestehenden statischen Website vorzunehmen. Er eignet sich besonders für die iterative Verfeinerung nach der initialen Seitenerstellung und zielt darauf ab, wie eine sorgfältige lokale Bearbeitung zu wirken, nicht wie ein neuer Generierungsdurchlauf. Der Agent akzeptiert Eingaben wie den existierenden Site-Ordner, Zielseiten, Screenshots oder natürlichsprachliche Beschreibungen des gewünschten Bereichs. Der Workflow umfasst das Aufsuchen des Zielbereichs im Browser, das Lesen der EDITING.md-Datei, die Identifikation der relevanten HTML/CSS/JS-Quellen und die Durchführung der kleinstmöglichen kohärenten Änderung. Nach dem Editieren wird das Ergebnis im Browser überprüft. Wichtig sind die lokalitätserhaltende Bearbeitung (z. B. Vermeidung von globalen CSS-Variablen, root-absoluten Pfaden) und die Validierung des betroffenen Bereichs. Der Skill aktualisiert nur dann die EDITING.md, wenn sich die Anleitung für zukünftige Änderungen ändert. Er setzt voraus, dass ein interaktives Browser-Tool (Browser-Plugin, devtools-gestützter Browser) verfügbar ist; andernfalls wird der Nutzer gebeten, es zu aktivieren, oder es wird auf Playwright oder Quelltextinspektion ausgewichen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Seitenteil bearbeiten

Ziel

Eine gezielte Verbesserung an einem Teil einer bestehenden statischen Website vornehmen, während der Rest der Website erhalten bleibt.

Dieser Skill ist für die iterative Verfeinerung gedacht, nachdem eine Seite bereits existiert. Es soll sich wie eine sorgfältige lokale Bearbeitung anfühlen, nicht wie ein neuer Generierungsdurchlauf.

Vertrag

Eingaben:

  • Vorhandener statischer Site-Ordner, Zielseite, Screenshot/lokale URL oder natürlichsprachliche Beschreibung des Zielbereichs.
  • EDITING.md und relevante HTML/CSS/JS-Dateien.
  • Gewünschte Vorher/Nachher-Text-, Stil-, Responsive- oder kleine Interaktionsänderung.

Ausgaben:

  • Eine fokussierte Bearbeitung des betroffenen Seitenabschnitts, der Komponente, des Textblocks, der Stilregel oder der kleinen Interaktion.
  • Aktualisierte EDITING.md nur, wenn sich die Anweisungen für zukünftige Änderungen ändern müssen.
  • Kurzer Bericht darüber, wo die Änderung vorgenommen wurde, welche Dateien geändert wurden und welche Validierung durchgeführt wurde.

Grenzen:

  • Baue die gesamte Seite nicht neu, ändere nicht die Theme-Richtung, importiere keine Beiträge, personalisiere nicht viele Felder und veröffentliche nicht.
  • Berühre keine nicht verwandten Seiten/Assets.
  • Führe keine Abhängigkeiten, Build-Schritte oder root-absolute site-lokale Pfade ein.

Erfolgskriterium:

  • Die angeforderte lokale Änderung ist im selben Browserbereich sichtbar, der vor der Bearbeitung bestätigt wurde.
  • Desktop/Mobil oder Interaktionsprüfungen für die betroffene Oberfläche bestehen.
  • Es wurden keine nicht verwandten Layout- oder Navigationsänderungen eingeführt.

Wenn das Kriterium nicht erfüllt ist:

  • Ordne den Browserbereich der Quelle neu zu und nimm die kleinste korrigierende Änderung vor.
  • Führe review-static-site aus oder schlage es vor, wenn das Problem die gemeinsame Navigation, viele Seiten, Assets, Kodierung oder die Veröffentlichungsbereitschaft betrifft.

Verwende dies, wenn

Verwende diesen Skill, wenn der Benutzer darum bittet:

  • Einen Abschnitt, eine Karte, einen Block, eine Komponente oder einen Seitenbereich zu ändern.
  • Ein visuelles Detail kleiner, ruhiger, dichter, sauberer, verspielter, technischer oder weniger ablenkend zu machen.
  • Ein mobiles Layoutproblem, Textüberlauf, Abstandsproblem oder eine ungünstige Ausrichtung zu beheben.
  • Eine kleine Interaktion anzupassen, wie Hover, Theme-Umschalter, Menüverhalten, Kopier-Button, Filter, Tab oder Animation.
  • Einen bestimmten sichtbaren Text umzuschreiben oder zu kürzen.
  • Einen Screenshot oder Benutzerkommentar für einen lokalisierten Bereich zu treffen.

Verwende diesen Skill nicht für die vollständige Seitengenerierung, Themensuche, detailgetreue Nachbildung einer neuen Referenzseite, großen Austausch von persönlichen Inhalten, Artikelmigration, Deployment oder Framework-Konvertierung.

Eingaben

Verwende, was der Benutzer bereitstellt:

  • Site-Root-Ordner und Zielseite.
  • Einen Screenshot, eine Browseransicht, eine lokale URL oder eine natürlichsprachliche Beschreibung des Problems.
  • Den genauen Text, Abschnittsnamen, Klassennamen oder den visuellen Bereich, der geändert werden soll.
  • EDITING.md, falls vorhanden.
  • Vorhandene HTML/CSS/JS-Dateien.
  • Jegliche gewünschte Vorher/Nachher-Formulierung oder Stilrichtung.

Wenn der Zielbereich mehrdeutig ist, inspiziere die Seite und treffe die kleinste sinnvolle Interpretation. Frage nur dann nach einer kurzen Klärung, wenn mehrere plausible Änderungen zu sehr unterschiedlichen Ergebnissen führen würden.

Arbeitsablauf

  1. Vor der Bearbeitung den Zielbereich im Browser bestätigen.
  2. EDITING.md lesen, falls vorhanden, dann das relevante HTML/CSS/JS inspizieren.
  3. Suche verwenden, um passende sichtbare Texte, IDs, Klassen, Datenblöcke oder komponentenähnliches Markup zu finden.
  4. Den bestätigten Browserbereich den relevanten Quelldateien, Selektoren, Datenblöcken oder Event-Handlern zuordnen.
  5. Die kleinste kohärente Änderung vornehmen, die die Anfrage erfüllt.
  6. Die vorhandene Designsprache beibehalten, es sei denn, der Benutzer bittet ausdrücklich darum, sie zu ändern.
  7. Nach der Bearbeitung zur selben Seite und demselben Bereich im Browser zurückkehren und die Änderung dort überprüfen.
  8. Berichten, was geändert wurde, und auf erforderliche Nachfolgevalidierung hinweisen.

Umfangskontrolle

Halte die Änderung lokal.

  • Bevorzuge die Bearbeitung des vorhandenen Abschnitts, der Klasse oder des Datenobjekts anstatt ein paralleles Duplikat zu erstellen.
  • Vermeide es, die gesamte Seite neu zu schreiben, wenn eine Änderung auf Abschnittsebene ausreicht.
  • Vermeide es, gemeinsame CSS-Variablen zu ändern, es sei denn, der Benutzer wünscht eine seitenweite Stiländerung.
  • Vermeide es, nicht verwandte Seiten, Assets oder Inhalte zu berühren.
  • Bewahre Navigation, Seitenübersicht, Platzhalterstrategie und EDITING.md-Konventionen.
  • Bewahre die Pfadstrategie der Seite; führe während einer lokalen Änderung keine root-absoluten site-lokalen Pfade wie /assets/..., /posts/..., /images/... oder /data/... ein.
  • Wenn eine kleine Anfrage ein größeres strukturelles Problem offenbart, erkläre den Kompromiss, bevor du weitreichende Änderungen vornimmst.

Wenn der Benutzer eine breite visuelle Verschiebung über mehrere Seiten hinweg wünscht, schlage stattdessen einen Skill zur größeren Generierung oder Neugestaltung vor.

Die richtige Stelle finden

Verwende eine schichtweise Suche:

  1. Suche nach dem sichtbaren Text oder nahegelegenen Beschriftungen.
  2. Durchsuche EDITING.md nach der Abschnitts-/Seitenübersicht.
  3. Inspiziere Navigationslinks und Dateinamen der Seiten.
  4. Inspiziere semantische Tags wie header, main, section, article, aside und footer.
  5. Inspiziere CSS-Selektoren und JavaScript-Event-Hooks.
  6. Verwende Browser-Entwicklertools oder Screenshots, wenn die Quellposition nicht offensichtlich ist.

Wenn wiederholter Inhalt aus Daten gerendert wird, bearbeite die Quelldaten anstatt nur das generierte Markup.

Design bewahren

Füge die Änderung in die aktuelle Seite ein.

  • Verwende vorhandene Abstände, Typografie, Farben, Rahmen, Schatten, Symbole und Bewegungsmuster wieder.
  • Halte den Text innerhalb seines Containers auf Desktop und Mobilgeräten.
  • Vermeide, dass dekorative Effekte das Lesen beeinträchtigen.
  • Respektiere prefers-reduced-motion beim Ändern von Animationen.
  • Halte Artikel/Detailseiten ruhiger als stark gestaltete Startseiten, es sei denn, der Benutzer bittet anders.
  • Füge einer persönlichen Website oder einem Blog keinen Marketing-Hero oder nicht verwandten dekorativen Abschnitt hinzu.

Beim Ändern von Text, passe die vorhandene Stimme und die Sprache des Benutzers an.

Interaktionsänderungen

Für JavaScript- oder Interaktionsänderungen:

  • Finde vorhandene Event-Listener und Statuskonventionen, bevor du neue hinzufügst.
  • Behalte Vanilla-JavaScript bei, wenn die Seite statisch ist.
  • Vermeide das Einführen von Abhängigkeiten oder Build-Schritten.
  • Verwende beim Generieren von Links, Suchergebnissen, Bild-URLs oder Navigationselementen in JavaScript seitenrelative Pfade, die aus der Tiefe der betroffenen Seite funktionieren.
  • Teste Klick-, Tastatur-, Mobil- und wiederholte Nutzungszustände, wenn relevant.
  • Bewahre grundlegende Barrierefreiheit wie Fokus, Labels und Reduced-Motion-Verhalten.

Responsive-Fixes

Für Layout- oder Mobilprobleme:

  • Überprüfe sowohl Desktop- als auch Mobilbreiten.
  • Bevorzuge CSS-Änderungen, die das Desktop-Layout bewahren, während schmale Bildschirme repariert werden.
  • Verwende stabile Abmessungen, Umbrechen, Min-/Max-Breiten, Grid/Flex-Anpassungen und Überlaufkontrolle.
  • Verstecke keine wichtigen Inhalte auf Mobilgeräten, nur um das Layout zu reparieren.

Bearbeitungsanleitung

Wenn die Änderung beeinflusst, wie zukünftige Änderungen vorgenommen werden sollten, aktualisiere EDITING.md.

Aktualisiere sie, wenn:

  • Ein neuer Abschnitt, eine neue Klasse, ein neues Datenfeld oder ein neues Interaktionsmuster eingeführt wird.
  • Die Speicherung von Inhalten in eine neue Datei oder ein neues Datenobjekt verlagert wird.
  • Der Benutzer eine Änderung angefordert hat, die zukünftige Agenten möglicherweise beibehalten müssen.

Aktualisiere EDITING.md nicht für winzige Text- oder Abstandsänderungen, es sei denn, die Anleitung wäre sonst irreführend.

Validierung

Validiere die betroffene Oberfläche, nicht unbedingt die gesamte Seite.

Verwende ein tatsächlich verfügbares interaktives Browser-Tool vor der Bearbeitung, um die Zielseite und den Zielbereich zu bestätigen. „Verfügbar" bedeutet, dass es in der aktuellen Runde in der aufrufbaren Tool-Liste enthalten ist. In Codex kann dies das Browser/in-app Browser-Plugin sein, wenn es in die Runde geroutet wird; in anderen Agenten kann es ein gleichwertiger sichtbarer Browser, ein Browser-Use-Tool oder ein devtools-gestützter Browser sein. Kehre nach der Bearbeitung zu derselben Seite und demselben Bereich im interaktiven Browser zurück, um das Ergebnis zu überprüfen.

Wenn kein interaktives Browser-Tool aufrufbar ist, tue nicht so, als hätte die Vorher/Nachher-Browserbestätigung stattgefunden. Bitte den Benutzer, das Browser-Tool zu aktivieren oder aufzurufen, wenn die Änderung von der visuellen Bereichszuordnung abhängt; für Codex kann dies bedeuten, eine Anfrage zu senden, die explizit @browser erwähnt. Wenn der Benutzer nicht umleitet oder der Client kein solches Tool hat, greife auf Playwright, Screenshots oder Quelltextinspektion zurück und gib die Einschränkung an.

Standardmäßig nicht auf Playwright, Screenshot-only-Validierung oder alleinige Quelltextinspektion zurückgreifen, wenn ein interaktives Browser-Tool tatsächlich aufrufbar ist. Verwende Playwright nur als Fallback, wenn kein interaktives Browser-Tool aufrufbar ist, wenn der Benutzer explizit danach fragt oder wenn eine wiederholbare, skriptbasierte Regression speziell benötigt wird.

Für visuelle, responsive oder interaktive Änderungen überprüfe den geänderten Bereich in den relevanten Desktop-/Mobil-Viewports und übe die geänderte Interaktion aus.

Führe review-static-site nur aus oder schlage es vor, wenn die Änderung die gemeinsame Navigation, das globale Layout, viele Seiten, Asset-Pfade, Quellkodierung oder die Veröffentlichungsbereitschaft betrifft.

Wenn die Änderung href, src, CSS url(...), Bilder, Schriftarten, Favicons, Datendateien oder JavaScript-generierte URLs berührt, überprüfe, ob die betroffene Seite immer noch mit seitenrelativen Pfaden funktioniert und dass das direkte Öffnen der statischen Datei nicht zu einem Verlust von CSS, JS oder Bildern führt.

Ausgabe

Berichte für lokale Änderungen nur:

  • Wo die Änderung vorgenommen wurde.
  • Welche Dateien geändert wurden.
  • Welche Validierung durchgeführt wurde.

Erwähne eine breitere review-static-site-Validierung nur, wenn sie tatsächlich empfohlen wird. Wiederhole den Bericht nicht und erkläre nicht die gesamte Codebasis übermäßig.

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 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

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

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