Communitygithub.com

GiantClam/shpitto

Typspezifischer Generierungsvertrag für persönliche Portfolio- und Blog-Websites. Verwendung für Lebensläufe, Creator-Seiten, Beraterprofile und schriftstellerisch geprägte persönliche Websites.

Was ist shpitto?

Dieses Skill, Portfolio Blog Site, ist ein spezialisierter Generierungsvertrag für das Erstellen persönlicher Websites, die Einzelpersonen, Kreative, Berater oder Autoren repräsentieren. Es ist für Plattformen wie Claude Code, Cursor und Codex konzipiert und stellt sicher, dass die generierte Website eine persönliche Erzählung und einen redaktionellen Rhythmus betont, anstatt eine typische Unternehmenswebsite zu imitieren. Das Skill definiert klare Verträge für die Startseite, den Blog-Bereich, die visuelle Identität und die gemeinsame Shell, um ein kohärentes, authentisches persönliches Publikationsgefühl zu gewährleisten. Es priorisiert echte redaktionelle oder kontextbezogene Bilder gegenüber Füllmaterial und segmentiert die Blog-Detailgenerierung als separaten Workflow, um iterative Inhaltserstellung zu ermöglichen, ohne das anfängliche Seitengerüst zu überlasten. Entwickler profitieren von einem strukturierten System, das Inhaltsentscheidungen leitet und Personal Branding, redaktionelle Glaubwürdigkeit und ein professionelles, schriftstellerisch geprägtes Erscheinungsbild sicherstellt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GiantClam/shpitto/tree/HEAD/apps/web/skills/portfolio-blog-site

In Ihrer bevorzugten KI fragen

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

Dokumentation

Portfolio-Blog-Seite

Verwenden Sie dieses Skill, wenn die Website eine Einzelperson, einen Kreativen, Berater oder ein schriftstellerisch geprägtes persönliches Profil repräsentiert.

Kernvertrag

  • Die persönliche Identität und Sichtweise dürfen die Startseite anführen.
  • Blog oder Schreiben kann eine erstklassige Route und narrative Oberfläche sein.
  • Erzählung, redaktioneller Rhythmus und Profil-Storytelling sind hier auf eine Weise erlaubt, die sie für corporate-b2b-site nicht sind.
  • Erzwingen Sie keine Erwartungen einer Unternehmensschale auf eine echte Portfolio-/Blog-Seite.

Startseitenvertrag

  • Die Startseite muss die genannte Person, ihr technisches Urteilsvermögen und warum das Publikum ihrem Schreiben oder ihren Dienstleistungen vertrauen sollte, vorstellen, bevor die Besucher zu /blog weitergeleitet werden.
  • Behandeln Sie / als eine profilgeführte redaktionelle Startseite, nicht als generischen Marketing-Helden und nicht als komprimiertes Artikelverzeichnis.
  • Bevorzugte Startseitenabfolge:
    • profilgeführter Kopfbalken
    • Expertise- oder redaktionelle Säulen
    • ausgewähltes Schreib-/Nachweisband
    • präziser CTA- oder Kontaktstreifen
  • Lassen Sie die Startseite nicht wie einen Archiv-Erklärer, Routenhinweis oder "Hier starten"-Mechanik-Panel wirken.
  • Wenn der Startseitenauftakt oder das erste Trägerband einen visuellen Slot verwendet, muss dieser Slot entweder sein:
    • ein echtes Betreiber-/Publikationskontextbild, oder
    • ein dichtes Schreib-/Nachweis-Modul mit spezifischer Artikels-, Dienstleistungs- oder Glaubwürdigkeitssubstanz.
  • Geben Sie keine informationsarmen visuellen Füllungen wie blasse Verlaufsrechtecke, leere Kontextkarten, schwache rechte Seitenleisten, dekorative Platzhalterboxen oder "Featured Context"-Panels aus, die kaum echte Beweise enthalten.
  • Wenn kein glaubwürdiges Bild verfügbar ist, ersetzen Sie den Medien-Slot durch ein substanzielles Schreib-Highlight, einen redaktionellen Beweisstapel oder ein Betreiber-Nachweis-Modul, anstatt eine dekorative Platzhalteroberfläche auszuliefern.
  • Wenn eine Startseite oder ein Trägerband eine Links-Rechts-Komposition verwendet, müssen der Textblock und der Medienblock als ein bewusstes Paar-Layout ausgerichtet sein. Rendern Sie keine hohe Textplatte neben einer kleinen schwebenden Bildkachel mit nicht übereinstimmenden Höhen oder nicht zusammenhängenden Grundlinien.
  • Wenn das Layout ein seitliches Bild verwendet, machen Sie dieses Bild zu einem richtigen Begleitpanel oder einer Karte mit stabilem Seitenverhältnis, gemeinsamer vertikaler Ausrichtung und genügend visuellem Gewicht, um die Kopierspalte auszugleichen.

Visueller Identitätsvertrag

  • Portfolio-/Blog-Oberflächen dürfen nicht dasselbe visuelle System wie Unternehmens-, Dokumentations- oder institutionelle Inhalts-Hub-Seiten verwenden.
  • Bevorzugen Sie eine redaktionelle Technologie-Journal-Ästhetik mit warmen Papier- oder Graphit-Neutraltönen, einer disziplinierten Akzentfarbe, lesbarer Langform-Typografie und starker Artikelkarten-Hierarchie.
  • Standardmäßig sollte nicht das generische grün-weiße abgerundete Kartenthema verwendet werden.
  • Die dominierende Komposition sollte sich wie eine polierte persönliche Publikation anfühlen: Profilkopfbalken, Essaykarten, Artikel-Leads, redaktioneller Nachweis und kompakte Kontaktmomente.

Blog-Routenvertrag

  • /blog kann ein erstklassiges Archiv sein, muss aber eine echte Website-Route mit demselben gemeinsamen Header, Footer, CSS-System und Navigationsvertrag wie der Rest der Website bleiben.
  • Der standardmäßige erste Website-Generierungsdurchgang muss eine starke /blog/index.html-Archivseite garantieren, nicht einen vollständigen Satz von /blog/{slug}/index.html-Artikelseiten.
  • Wenn das Archiv Startartikelthemen zeigt, behalten Sie diese als archivbereite Karten, Zusammenfassungen oder Sammlungseinträge im ersten Durchgang bei. Zwingen Sie den Hauptworkflow nicht, jede Detailseite vorab fertigzustellen.
  • Die Blog-Detailgenerierung ist eine separate Workflow-Phase. Führen Sie sie nach der Bereitstellungsbereitschaft und vor der Bindung einer benutzerdefinierten Domain aus, oder wenn der Benutzer die Artikelgenerierung manuell auslöst.
  • Wenn der dedizierte blog-detail-fill-workflow aktiv ist, muss jede angeforderte /blog/{slug}/-Route zu einer stabilen, Slug-ausgerichteten Detailseite mit echter Langform-Struktur werden: eine routeneigene H1, eine starke Einleitung, mehrere substanzielle H2-Abschnitte und genügend echten Fließtext, um wie fertiges technisches Schreiben zu lesen.
  • Erfinden Sie keine Archiv-Kategorie-, Tag- oder Autorenindex-Routen, es sei denn, das bestätigte Manifest schließt sie explizit ein.
  • /blog darf nicht als riesige Textplatte plus eine leere oder schwache visuelle Seitenleiste öffnen. Wenn die Route ein unterstützendes Archivkontext-Panel verwendet, benötigt dieses Panel echte Archivbeweise: vorgestellte Beiträge, Publikationshinweise, Lesethemen oder routeneigene visuelle Substanz.
  • Archiv- und Auflistungsoberflächen sollten Bild-Text-Artikelkarten bevorzugen, wenn ein glaubwürdiges unterstützendes Bild verfügbar ist. Standardmäßig sollten Archive nicht auf reine Textblöcke gesetzt werden, wenn die Route bereits Platz für gepaarte redaktionelle Miniaturansichten oder Nachweisbilder hat.
  • Produktähnliche Präsentationen, Artikelbücher, vorgestellte Schreibstreifen und Nachweisregale sollten integrierte Bild-Text-Karten gegenüber getrennten Textzeilen plus einem losgelösten visuellen Platzhalter bevorzugen.

Gemeinsamer Shell-Vertrag

  • Header, Nav-Reihenfolge, Footer-Ziele und gemeinsame Stylesheet-/Skript-Referenzen müssen über /, /blog, /about, /contact und alle expliziten /blog/{slug}/-Routen hinweg konsistent bleiben.
  • Für einen kompakten Routensatz wie Home / Blog / About / Contact sollten Desktop- und Tablet-Header die primären Links direkt rendern. Lassen Sie keinen sichtbaren Text-Menu-Button in der Desktop-Navigation, wenn die Links bereits in eine Zeile passen.
  • Wenn ein Offenlegungstrigger für schmale Breiten verwendet wird, muss er nur für Mobilgeräte sein und durch passendes CSS und JavaScript unterstützt werden. Liefern Sie keinen Header aus, bei dem der Umschalter sichtbar ist, die Navigation aber nie eingeklappt wird.
  • Interne Routen können in den Eröffnungsmodulen und im redaktionellen Rhythmus variieren, aber sie dürfen den Footer nicht auf eine flache Rechtszeile reduzieren oder in ein einmaliges Shell-Markup abweichen.
  • Der gemeinsame Shell-Text muss für Besucher ausgerichtet bleiben. Legen Sie Implementierungshinweise, Artikelanzahl-Anweisungen, Workflow-Text zum Veröffentlichen oder Design-System-Rationale im sichtbaren Text nicht offen.
  • Blog-Detailseiten müssen denselben gemeinsamen Footer-Zielsatz wie die Startseite und das Blog-Index erben.
  • Der Footer muss eine strukturierte Footer-Shell verwenden, keine bloße pagefoot-Zeile oder flache Ankerkette. Minimale Form:
    • ein Footer-Band mit sichtbarer Trennung vom Hauptinhalt
    • eine Identitäts-/Markenzone
    • eine Navigations-/Linkzone
    • eine Support-/Meta-/Aktionszone
  • Wenn gemeinsames CSS Footer-Shell-Dienstprogramme wie site-footer__inner, footer-grid, footer-brand, footer-links, footer-nav, footer-meta, footer-actions, footer-bottom oder äquivalente BEM-/Footer-Spaltenklassen definiert, muss das HTML-Footer dieselben strukturierten Zonen verwenden, anstatt auf eine einzige Inline-Zeile zu kollabieren.
  • Die Footer-Gruppierung muss eindeutig bleiben. Wiederholen Sie nicht denselben Routensatz unter mehreren Überschriften wie sowohl Primary navigation als auch Key sections; jede Footer-Gruppe benötigt eine separate Aufgabe.

Textausschlüsse

  • Legen Sie routenmechanische Formulierungen wie "start with these three articles", "this page collects", "reading order" oder "continue to the next page" nicht offen.
  • Legen Sie interne QA- oder Layout-Labels wie Responsive layout, Shared shell, Desktop and mobile review, homepage groups oder visual system keeps nicht offen.
  • Verwenden Sie in sichtbarer Blog-Detail-Prosa keine Platzhalter-Artikelfüllungen, TODO-Labels, Lorem Ipsum oder abstrakte Inhaltsstrategie-Kommentare.

Medienpräferenz

  • Wenn der Brief eine technische persönliche Website, ein Beraterprofil oder eine schriftstellerisch geprägte Publikation ist, bevorzugen Sie echte Betreiber-/Redaktionskontext-Bildsprache auf / und /blog, wann immer die Route bereits visuellen Platz reserviert.
  • Gute Übereinstimmungen umfassen Fotografie von Arbeitsplatz, Schreibtisch, Besprechungstisch, Notizbuch, Redaktion, Forschung oder Implementierungskontext, die den Routenzweck verstärkt.
  • Füllen Sie diese Slots nicht mit abstrakten Verläufen, leeren Karten, generischen Ikonenmosaiken oder schwachen Support-Leisten, wenn ein glaubwürdiges Kontextbild verfügbar ist.

Individual skills in this repo

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

Verwandte Skills