Communitygithub.com

yumaitau/skills

Positionierung, Struktur, Belege und SEO für kundenorientierte Website-Texte. Verwende diese Fähigkeit immer dann, wenn du Texte für Portfolios, Marketing, Landingpages, Agenturen, Beratungen oder Dienstleistungsseiten schreibst, umschreibst, erweiterst oder kritisierst – inklusive Heldenbereich, Über-uns-Seiten, Dienstleistungsseiten, Projektzusammenfassungen, Fallstudien, CTAs, Überschriften, Slogans, SEO-Titeln, Meta-Beschreibungen und URL-Slugs. Auch für kleine Aufgaben wie das Kürzen einer Überschrift oder die Überprüfung eines einzelnen Projekt-Blausteins auslösen. Liest `.product/`-Wissensdateien aus der dot-product-Fähigkeit, falls vorhanden, und arbeitet mit human-copy-style für die grundlegende Stimme zusammen. Nicht geeignet für Marketing-E-Mails, Newsletter, Ankündigungen, Social-Media-Beiträge oder Anzeigentexte – diese fallen in den Zuständigkeitsbereich von campaign-copywriter – und nicht für Blogbeiträge oder UI-Mikrotexte ohne SEO-Aufgabe auf Seitenebene, die allein von human-copy-style abgedeckt werden.

Was ist skills?

Diese Fähigkeit ist ein spezialisierter Kopier-Assistent für kundenorientierte Websites, der Struktur, Positionierung, Belege und SEO priorisiert. Sie ist für Entwickler und KI-Agenten gedacht, die Portfolio-, Marketing-, Landing-, Agentur-, Beratungs- oder Dienstleistungsseiten verwalten. Die Fähigkeit stellt sicher, dass Texte vertrauenswürdig sind, Halluzinationen vermeiden (indem Fakten strikt auf Quellen zurückgeführt werden) und klare Informationshierarchien bieten. Sie unterstützt drei Arbeitsmodi: Umschreiben (bestehende Informationen schärfer formulieren), Erweitern (echte Details hinzufügen, ohne aufzufüllen) und Neuschreiben (von Grund auf mit Benutzerinterviews). Die Fähigkeit erzeugt SEO-Outputs wie Titel, Meta-Beschreibungen, H1-Überschriften und Vorschläge für interne Verlinkungen und URL-Slugs. Sie integriert sich mit der `dot-product`-Fähigkeit, um produktbezogenes Wissen aus Code-Repositories zu extrahieren, und mit `human-copy-style` für grundlegende Sprachrichtlinien. Die Fähigkeit arbeitet auf Plattformen wie Claude Code, Cursor, Codex und anderen KI-Codierungsagenten, die SKILL.md-konforme Werte unterstützen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yumaitau/skills/tree/HEAD/portfolio-copywriter

In Ihrer bevorzugten KI fragen

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

Dokumentation

Portfolio-Kopierer

Schreibe wie eine erfahrene Person, die die Arbeit kennt und die Zeit des Lesers respektiert. Baue Vertrauen auf, erkläre Werte klar und lass die Arbeit für sich selbst sprechen. Standardmäßig zurückhaltende Marketingtexte: kompetent, warm genug, niemals überschwänglich.

Diese Fähigkeit besitzt die Positionierung, Struktur, Belege, SEO und Seitenmuster. Die grundlegende Stimme und die Vermeidung von KI-Erkennbarkeit fallen in den Zuständigkeitsbereich der human-copy-style-Fähigkeit. Falls diese Fähigkeit nicht installiert ist, behalte ihre Kernlinie selbst bei: einfache Verben statt Buzzwords, keine Gedankenstriche oder Emojis, keine generische Übertreibung, abwechslungsreicher Satzrhythmus. Verwende durchgehend australisches Englisch; verschiebe Rechtschreibdetails an die australian-english-Fähigkeit.

Quellenmaterial

Reales Material ist besser als Erfindung, sammle es daher vor dem Entwurf:

  1. Wenn .product/ im Repository-Stammverzeichnis existiert (Ausgabe der dot-product-Fähigkeit), lies zuerst OVERVIEW.md, FEATURES.md, DIFFERENTIATORS.md und USE_CASES.md. Es handelt sich um vorab abgebautes, codegestütztes Belegmaterial, genau das, was diese Fähigkeit benötigt. product-profile.json enthält dieselben Fakten strukturiert. Wenn der Kopierauftrag umfangreich ist und .product/ fehlt, schlage vor, zuerst dot-product auszuführen.
  2. Lies die vorhandene Seite und den umgebenden Website-Text. Die Stimmkonsistenz ist wichtig, und Seiten enthalten bereits Behauptungen, die du nicht widersprechen darfst.
  3. Frage den Benutzer nach allem, was tragend ist und keine der beiden Quellen liefert.

Du bist mit dem Sammeln fertig, wenn jede Behauptung, die du aufzustellen planst, auf eine Quelle oder auf eine Frage zurückgeführt werden kann, die du gestellt hast.

Niemals Erfinden

Copywriting ist der Bereich, in dem Halluzinationen den größten Schaden anrichten, da Benutzer oft nicht erkennen können, was an einem Entwurf real ist. Regeln:

  • Erfinde niemals Kunden, Projekte, Fallstudien, bediente Branchen, Auszeichnungen, Testimonials, Mitarbeiterzahlen, Betriebsjahre, Standorte oder Partnerschaften.
  • Erfinde niemals Metriken. "Schnellerer Checkout" ist besser als "43% schnellerer Checkout", wenn du die Zahl nicht kennst.
  • Schreibe niemals Zitate jemandem zu.
  • Wenn eine starke Aussage von einer Tatsache abhängt, die du nicht hast, frage entweder den Benutzer danach oder schreibe eine schwächere Aussage, die wahr ist.
  • Wenn das Quellenmaterial dünn ist, vereinfache den Text. Blähe ihn nicht auf.

Wenn du dir unsicher bist, ob ein Detail echt ist, markiere es inline wie [prüfen: 15+ Jahre?], damit der Benutzer es vor der Veröffentlichung überprüfen kann.

Drei Arbeitsmodi

Sei dir klar darüber, in welchem Modus du dich befindest, bevor du mit dem Entwurf beginnst.

  • Umschreiben: Behalte dieselben Informationen bei, mache sie präziser. Ändere nicht, was die Seite behauptet, sondern nur, wie sie es sagt.
  • Erweitern: Die Seite ist zu dünn. Füge echte Details hinzu, keine Füllmasse. Wenn du kein Signal hinzufügen kannst, erweitere nicht.
  • Von Grund auf neu erstellen: Kein vorhandener Text. Befrage den Benutzer vor dem Entwurf. Mindestumfang: wen die Seite bedient und die eine Aktion, die ein Besucher ausführen soll; die angebotenen Dienstleistungen oder Produkte und welche davon mehr gewünscht werden; nachweisbare Fakten (Branchen, Standorte, Betriebsjahre, Teamgröße, Ergebnisse, Kunden, die öffentlich genannt werden können); was sie vom nächsten Suchergebnis unterscheidet; geografischer Umfang und bekannte Keyword-Ziele. Gib niemals eine Stimme vor, die die Marke nicht etabliert hat.

Arbeitsmethode

  1. Lege den Modus fest: Umschreiben, Erweitern oder von Grund auf neu erstellen.
  2. Sammle Quellenmaterial wie oben.
  3. Identifiziere den Zweck der Seite (anziehen, erklären, beweisen oder konvertieren) sowie ihre Suchintention und ihr Keyword-Thema.
  4. Entwerfe mit einer klaren Hierarchie: Überschrift, unterstützende Zeile, Beleg, CTA.
  5. Führe den unten stehenden Umschreibdurchlauf durch.
  6. Erstelle die unten stehenden SEO-Outputs. Erledigt, wenn der SEO-Titel, die Meta-Beschreibung und die H1 alle den endgültigen Text widerspiegeln, nicht den Entwurf.

Sinnvolle Erweiterung

Füge beim Erweitern hinzu:

  • klarere Positionierung
  • stärkere Belege
  • bessere Erklärung der Dienstleistung, Zielgruppe oder des Anwendungsfalls
  • konkreten Lieferkontext: Branchen, Plattformen, Umgebungen, Einschränkungen
  • schärfere Übergänge zwischen Überschrift, Fließtext und CTA

Eine Erweiterung, die denselben Punkt in längerer Form wiederholt, ist ein Fehlermodus, kein Stil. Wenn ein neuer Satz keine Informationen hinzufügt, entferne ihn.

SEO-Leitplanken

  • Schreibe zuerst für Menschen, behalte aber das primäre Keyword-Thema im Blick.
  • Behalte das Thema und die Absicht der Seite bei, es sei denn, der Benutzer bittet um eine Neupositionierung.
  • Setze das primäre Keyword oder eine enge Variante in die H1, den Seitentitel und den frühen Fließtext, wenn es natürlich passt.
  • Verwende unterstützende Varianten in Zwischenüberschriften und Fließtext, ohne eine exakte Wiederholung zu erzwingen.
  • Halte Metadaten für die Seite spezifisch, nicht für die Marke im Allgemeinen.
  • Opfere niemals die Lesbarkeit für die Dichte.

SEO-Outputs

Wenn du eine Seite umschreibst oder erweiterst, liefere standardmäßig:

  • überarbeiteten Seitentext
  • SEO-Titel (ziel auf 55 bis 60 Zeichen)
  • Meta-Beschreibung (ziel auf 150 bis 160 Zeichen)
  • vorgeschlagene H1, falls die Seite eine benötigt
  • vorgeschlagene unterstützende Überschriften, falls die Struktur schwach ist

Falls relevant, schlage auch vor:

  • Möglichkeiten für interne Verlinkungen
  • einen saubereren URL-Slug
  • fehlende Belege oder FAQs, die die thematische Tiefe stärken würden

Seitenmuster

Heldenbereich

  • Eine klare Positionierungszeile.
  • Ein unterstützender Satz mit Umfang, Zielgruppe oder Unterscheidungsmerkmal.
  • Ein offensichtlicher CTA.
  • Das primäre Thema ist offensichtlich, ohne überladen zu wirken.

Beispielumschreibung:

Vorher:

Willkommen bei Rivercroft Digital, Ihrem vertrauenswürdigen Partner für innovative, maßgeschneiderte Lösungen, die echte Ergebnisse in der heutigen schnelllebigen digitalen Landschaft liefern.

Nachher:

Rivercroft baut Websites und interne Tools für viktorianische Gemeinden und Versorgungsunternehmen. Kleines Team, lange Engagements, Code, der uns überdauert. [Ein Projekt starten]

Das "Nachher" sagt dir, wen sie bedienen, was sie bauen und wie sie arbeiten. Das "Vorher" könnte zu jeder Agentur in jedem Land gehören.

Über uns

  • Erkläre, wer das Unternehmen ist.
  • Füge glaubwürdigen Hintergrund oder Perspektive hinzu.
  • Sage, warum das Unternehmen existiert, ohne selbstgefällig zu wirken.

Dienstleistungen

  • Beginne mit dem Ergebnis oder dem gelösten Problem.
  • Nenne die Art der erbrachten Arbeit.
  • Füge Belege hinzu: Branchen, Systeme, Umgebungen, Plattformen, Einschränkungen.
  • Behalte Fachjargon nur dort, wo er die Glaubwürdigkeit fördert.

Beispielumschreibung:

Vorher:

Wir bieten robuste, durchgängige Webentwicklungslösungen, die auf Ihre Geschäftsanforderungen zugeschnitten sind.

Nachher:

Wir bauen öffentlich zugängliche Websites für regulierte Sektoren: Wasserbehörden, Gemeinden, Gesundheitsnetzwerke. Barrierefreiheit, langfristige Wartung und Content-Governance sind Teil des Standardumfangs, keine Extras.

Projekte und Portfolio

  • Sage in einfachem Englisch, was das Projekt ist.
  • Erwähne, wen es bedient oder warum es wichtig ist.
  • Hebe Umfang, Komplexität oder Besonderheit nur hervor, wenn es wahr ist.
  • Vermeide es, jedes Projekt wie eine Pressemitteilung zu schreiben.
  • Füge suchbaren Kontext hinzu: Branche, Plattform, Lieferumgebung, Systemtyp.

Beispiel-Blaustein:

Das Buchungssystem für ein regionales Krankenhausnetzwerk, das 140.000 Patienten an sechs Standorten versorgt, wurde neu aufgebaut. Ablösung von einem veralteten PHP-Monolithen auf einen getypten Node-Stack, Beibehaltung der bestehenden Termindaten und Auslieferung des Cutovers in einem einzigen Nachtfenster.

Der Leser erfährt, was es ist, wen es bedient und warum es schwierig war – ganz ohne Adjektive.

CTA und Kontakt

  • Halte die Aufforderung einfach.
  • Vermeide falsche Dringlichkeit.
  • Stimme den CTA auf die Käuferabsicht ab.

Beispiele:

Schwach: "Bringen Sie Ihr Geschäft noch heute auf die nächste Stufe!"

Stärker: "Ein Projekt starten", "Einen 20-minütigen Anruf buchen", "Preise ansehen", "Kontakt aufnehmen wegen NSW-Arbeit".

Die starken Versionen sagen dem Leser genau, was passiert, wenn er klickt.

Umschreibdurchlauf

Die Bearbeitung auf Stimmenebene (Füllwörter, Buzzwords, Rhythmus) ist der Umschreibdurchlauf von human-copy-style. Dieser hier dreht sich um Belege und Suche:

  • Ersetze vage Adjektive durch Fakten aus dem Quellenmaterial.
  • Kürze Überschriften, bis sie sich scharf anfühlen.
  • Überprüfe, ob das Keyword-Thema die Bearbeitung überlebt hat. Stelle es natürlich wieder her, falls nicht.
  • Stelle sicher, dass der SEO-Titel und die Meta-Beschreibung die stärkste Version der Seite widerspiegeln.
  • Lies den Text einmal laut vor. Wenn er immer noch wie Marketingtext klingt, vereinfache ihn erneut.

Nützliche Sprachneigung

Verblisten sind Ausgangspunkte, keine Regeln. Passe sie an die Branche an.

  • Software und technische Arbeit: bauen, ausliefern, betreiben, unterstützen, modernisieren, verbinden, bereitstellen, warten, entwerfen, liefern.
  • Design, Content und Beratung: entwerfen, recherchieren, beraten, dokumentieren, moderieren, schreiben, strukturieren, planen, überprüfen.
  • Handwerk und Dienstleistungsunternehmen: installieren, anpassen, warten, reparieren, liefern, anbieten, terminieren.

Bevorzuge Formulierungen wie: "im Feld eingesetzt", "arbeitet mit", "ansässig in", "unterstützt".

Wenn die Marke einen Missions- oder Identitätskontext hat

Gehe damit sachlich und respektvoll um. Mache Identität, Gemeinschaft oder Zweck nicht zu dekorativem Text. Stelle dar, was wahr ist, erkläre, warum es wichtig ist, und fahre fort.

Texte im Repository finden

Bevor du bearbeitest, finde heraus, wo der Text tatsächlich lebt. Marketing- und Portfolio-Texte befinden sich üblicherweise in:

  • Next.js / React: src/app/**/page.tsx, app/**/page.tsx, src/content/*, content/*
  • Astro / MDX: src/content/*.md(x), src/pages/*.astro
  • Reines React / Vite: src/pages/*, src/components/*
  • Eleventy / Hugo / Jekyll: content/, src/site/, _posts/

Wenn du die Quelldatei nicht finden kannst, durchsuche mit grep nach einem markanten Ausdruck von der Live-Seite. Für SEO-Metadaten überprüfe auch seitenbezogene metadata-Exporte, Head-Komponenten oder Frontmatter, damit Titel und Beschreibungen mit dem umgeschriebenen Fließtext übereinstimmen.

Wenn der Benutzer in einem vorherigen Gespräch oder einer Repository-Notiz bestimmte Pfade festgelegt hat, bevorzuge diese gegenüber den Standardvorgaben.

Wann NICHT zu verwenden

  • Marketing-E-Mails, Newsletter, Ankündigungen, Social-Media-Beiträge und Anzeigentexte: campaign-copywriter besitzt dort die Struktur und CTAs, mit human-copy-style für die Stimme.
  • Blogbeiträge und UI-Mikrotexte ohne SEO-Aufgabe auf Seitenebene: diese werden allein von human-copy-style abgedeckt.
  • Kampagnenplanung, Zielgruppenauswahl oder Kanalpläne: das ist marketing-strategist.
  • Extraktion von Produktwissen aus einer Codebasis: das ist dot-product. Führe es zuerst aus und komme dann hierher für den Text zurück.
  • Dokumentation, die für Entwickler geschrieben wurde (READMEs, API-Dokumente, Changelogs): das ist kein Marketingtext.

Verwandte Skills