Was ein Skill ist #
Ein Skill ist eine Anleitung in deinem Projekt, die deine KI liest, bevor sie handelt. Kein Programm, kein Knopf, keine Erweiterung, die du installierst. Es ist ein Text, geschrieben für die Maschine, mit dem Wissen, das ein erfahrener Mensch bei dieser Aufgabe im Kopf hätte.
Die Skills liegen in deinem Template im Ordner .claude/skills, ein Unterordner je Skill, darin jeweils eine Datei SKILL.md. Der Punkt am Anfang des Ordnernamens macht ihn versteckt, deshalb siehst du ihn im Dateimanager erst, wenn du versteckte Dateien einblendest. Der komplette Aufbau deines Templates steht im Kapitel Aufbau deines Templates.
- start · der Einstieg
- systemwissen · die Karte des Projekts
- template-aufbau · der Umbau zur echten Website
- design-system · Farben, Formen, Bilder
- copywriting · Ton und Textlängen
- seo · gefunden werden
- qualitaetspruefung · der Prüflauf
Du rufst Skills nicht auf, du beschreibst dein Ziel
Das ist der wichtigste Satz dieses Kapitels. Jeder Skill trägt in der ersten Zeile eine Beschreibung, wann er greift. Deine KI liest diese Beschreibungen, vergleicht sie mit dem, was du geschrieben hast, und zieht den passenden Skill von selbst heran. Du musst keinen Namen kennen und keinen Befehl auswendig lernen.
Schreibst du „Der Akzent soll ein dunkles Grün werden“, greift design-system. Schreibst du „Prüf bitte, ob nach den Änderungen alles noch stimmt“, greift qualitaetspruefung. Oft greifen mehrere nacheinander, ohne dass du es merkst. Die Namen in diesem Kapitel sind für den Fall gedacht, dass du einmal nachhelfen willst.
Teil 1 ist der universelle Kern und gilt für jede Website aus einem AI-Website-Template. Teil 2 ist auf dein Template gemünzt und nennt Dateinamen, Grenzwerte und die typischen Stolperstellen genau dieser Vorlage. Deshalb bekommst du konkrete Antworten statt allgemeiner Ratschläge.
Dort lauten die Namen start, system-knowledge, template-setup, design-system, copywriting, seo und quality-assurance. Inhalt und Wirkung sind identisch, nur die Sprache wechselt.
Die sieben auf einen Blick #
Diese Tabelle reicht für den Alltag. Wenn du wissen willst, wie ein Skill im Detail arbeitet, steht das in seinem eigenen Abschnitt weiter unten.
| Skill | Wofür er da ist | Typischer Satz |
|---|---|---|
| start | Der Einstieg. Führt in vier Gesprächsrunden durch den kompletten Umbau. | „Wo fange ich an?“ |
| systemwissen | Die Karte des Projekts. Erklärt, wo was gepflegt wird und wie die Teile zusammenhängen. | „Wo ändere ich die Telefonnummer?“ |
| template-aufbau | Aus der Vorlage wird deine echte Website. Baut auch neue Seiten und Sektionen im bestehenden Stil. | „Ersetz die Leistungen durch meine.“ |
| design-system | Farben, Logo, Radien, Abstände, Animationen und Bilder, zentral über Tokens. | „Der Akzent soll grün werden.“ |
| copywriting | Texte im Ton deiner Marke und in den Längen, die das Layout verträgt. | „Schreib die Startseite auf mich um.“ |
| seo | Titel, Beschreibungen, Struktur, strukturierte Daten, Sitemap und Domain. | „Optimier alle Titel auf meine Stadt.“ |
| qualitaetspruefung | Der Prüflauf nach jeder Änderung und die lange Liste vor dem Livegang. | „Prüf, ob alles noch stimmt.“ |
Start · Der Einstieg #
Der Skill für die erste Stunde. Er geht davon aus, dass du gerade bezahlt hast, vor einem fremden Ordner sitzt und deine Website willst, statt zu lernen, wie ein Projekt aufgebaut ist. Deshalb führt er ein Gespräch statt eines Fragebogens.
Er stellt eine Frage pro Nachricht und sagt jedes Mal dazu, wofür er die Antwort braucht. Er fragt nichts, was er selbst entscheiden kann. Er übersetzt jedes Fachwort. Und er zeigt dir nach jeder Runde etwas Sichtbares, damit du siehst, dass es vorangeht.
Die vier Runden
Wer du bist
Name deines Unternehmens, die Menschen dahinter, die Stadt und in einem Satz, was du anbietest. Daraus entstehen Logo, Seitentitel und die Identität, die auf jeder Seite auftaucht.
Harte Daten
Anschrift, Telefon, E-Mail, Erreichbarkeit und deine Domain. Diese Angaben landen im Fuß jeder Seite, auf der Kontaktseite und in den maschinenlesbaren Daten, die Suchmaschinen auslesen.
Dein Angebot
Deine Leistungen mit Ablauf, Formaten und Preislogik, dazu für wen sie gedacht sind. Daraus werden die Leistungssektionen, die Preisangaben und die passenden FAQ-Antworten.
Menschen und Belege
Hast du ein eigenes Foto? Echte Kundenstimmen mit schriftlicher Freigabe? Echte Zahlen und Projekte? Was du hast, kommt hinein. Was du nicht hast, fliegt heraus statt erfunden zu werden.
Nach Runde 4 übergibt der Skill an template-aufbau, der den systematischen Rest übernimmt. Das ganze Kapitel zum ersten Tag steht unter Erste Schritte.
Er greift von selbst, sobald du das Projekt zum ersten Mal öffnest, und immer dann, wenn eine Nachricht klingt wie „wo fange ich an“, „was kann ich hier machen“ oder „hilf mir mal“.
Ich habe dieses Template gerade gekauft und weiß nicht, wo ich anfangen soll. Führ mich Schritt für Schritt durch den Umbau und frag mich einzeln ab, was du brauchst.
Mach aus dieser Vorlage die Website von [Firmenname] in [Stadt]. Wir bieten [Leistung] an. Fang mit Runde 1 an und zeig mir nach jeder Runde, was sich geändert hat.
Bevor wir loslegen: Zeig mir, was auf dieser Website erfunden ist und vor dem Livegang ersetzt werden muss. Namen, Zahlen, Stimmen, Bilder.
Was er bewusst nicht tut. Er erfindet keine Angabe, die du ihm nicht gegeben hast. Fehlt etwas, landet es auf einer Liste offener Punkte statt im Text deiner Website.
Systemwissen · Die Karte #
Der Skill, der dir dein eigenes Projekt erklärt. Er kennt die Karte: welche Datei wofür zuständig ist, wo deine Texte liegen, welche Liste welche Sektion speist und welche Stellen zusammengehören.
Das ist mehr wert, als es klingt. In einer Website hängt vieles an mehreren Orten zusammen. Eine Telefonnummer steht als Anzeige und als anklickbarer Link. Eine Leistung erscheint auf der Startseite, auf der Leistungsseite und im Fuß. Wer nur eine Stelle ändert, hat eine halbe Website. Dieser Skill kennt die Paare.
- Wo etwas wohnt. Kontaktdaten, Navigation, Leistungen, Preise, Stimmen, Fragen und Antworten liegen in einer zentralen Datendatei. Seitenspezifische Texte stehen in der jeweiligen Seitendatei.
- Was automatisch mitzieht. Listen speisen ganze Sektionen. Ein neuer Eintrag erscheint von allein an der richtigen Stelle, ohne dass jemand ein Layout anfassen muss.
- Was nicht mitzieht. Einzelne Stellen sind fest hinterlegt, etwa Listen im Fuß der Seite oder Zahlwörter in Fließtexten. Der Skill nennt sie beim Namen.
- Wie ein Artikel entsteht. Ein Blogbeitrag braucht zwei Dinge, einen Eintrag in der Übersicht und eine eigene Seite. Fehlt eins davon, läuft ein Link ins Leere.
Er greift von selbst bei jeder Frage nach dem Wo und dem Wie. Er ist auch der richtige erste Schritt, wenn du eine größere Änderung planst und erst verstehen willst, was sie berührt.
Wo ändere ich die Telefonnummer, und an welchen Stellen der Website taucht sie überall auf?
Erklär mir in einfachen Worten, wie dieses Projekt aufgebaut ist. Welche Datei ist wofür zuständig, wo liegen meine Texte und was passiert automatisch, wenn ich dort etwas ändere?
Was er bewusst nicht tut. Er antwortet, statt loszubauen. Wenn du die Änderung gleich haben willst, sag es dazu, dann übernimmt der passende Skill.
Template-Aufbau · Der Umbau #
Der größte der sieben. Er macht aus der ausgelieferten Vorlage deine echte Website und ist danach für alles zuständig, was strukturell dazukommt, also neue Seiten, neue Sektionen, neue Angebote.
Sein Vorgehen ist erprobt und läuft immer gleich ab. Erst einsammeln, dann bauen. Vor dem ersten Handgriff fragt er deine echten Daten ab, statt sie unterwegs zu erfinden.
- Eine Tabelle alt gegen neu. Jeder erfundene Name, jede Stadt, jede Nummer, jede Beispiel-Firma bekommt einen Eintrag. Diese Tabelle ist am Ende die Prüfliste.
- In Blöcken arbeiten. Identität, dann Kontaktdaten, dann Leistungen und Preise, dann Belege, dann Artikel, dann Bilder, dann Titel und Beschreibungen, zuletzt die Rechtsseiten. Nach jedem Block wird gebaut und angesehen.
- Zahlwörter mitschleppen. Wird aus acht Leistungen fünf, steht die alte Zahl oft noch in einem Fließtext. Der Skill sucht danach.
- Der Null-Treffer-Beweis. Der Umbau gilt erst als fertig, wenn die Suche nach jedem Eintrag der Tabelle null Treffer liefert, Beugungsformen eingeschlossen.
Er greift von selbst, wenn du beschreibst, was aus der Vorlage werden soll, wenn du Inhalte ersetzen lässt und wenn etwas Neues gebaut wird, das es so noch nicht gibt.
Ersetz die Leistungen durch meine echten Angebote. Ich habe fünf statt acht, die Beschreibungen gebe ich dir gleich. Denk daran, dass die alte Anzahl auch in Fließtexten und im Fuß der Seite steht.
Leg eine neue Unterseite für [Leistung] an, im selben Aufbau wie die bestehenden Seiten, und häng sie in die Navigation.
Führ eine Liste alt gegen neu für alles Erfundene in diesem Projekt und arbeite sie ab. Zeig mir am Ende, dass die Suche nach jedem alten Eintrag null Treffer liefert.
Impressum und Datenschutz erzeugt kein Skill. Das wäre Rechtsberatung. Beide Seiten liegen als leere Platzhalter bereit, deine geprüften Texte werden 1:1 eingebaut. Das ganze Kapitel dazu steht unter Impressum und Datenschutz.
Was er bewusst nicht tut. Er hübscht erfundene Belege nicht auf. Zahlen, Kundenstimmen und Fallbeispiele werden entweder durch echte, freigegebene ersetzt oder entfernt.
Design-System · Farbe und Form #
Der Skill für alles Sichtbare, das keine Sprache ist. Farben, Logo, Rundungen, Abstände, Bewegung und Bilder. Sein Grundsatz ist einfach. Gestaltung wird an einer zentralen Stelle festgelegt und von dort überall gelesen.
Diese zentralen Werte heißen Tokens. Ein Markenwechsel ist deshalb eine Änderung an wenigen Zeilen statt einer Suche durch zwanzig Dateien. Und weil alles aus derselben Quelle kommt, bleibt die Website nach dem Wechsel stimmig statt fleckig.
- Der Farbwechsel ist eine Kette. Zu einer neuen Akzentfarbe gehören der helle Modus, der dunkle Modus, die Browserleiste auf dem Handy, das Favicon und der Styleguide. Der Skill zieht alles gemeinsam nach.
- Kontraste werden gemessen. Text ab 4,5 zu 1, Bedienelemente ab 3 zu 1, geprüft in beiden Farbmodi. Eine schöne Farbe, die niemand lesen kann, ist keine Option.
- Ein Akzent reicht. Mehr Farben verwässern die Marke. Wer Abwechslung will, variiert Flächen und Größen statt Farbtöne.
- Bilder liegen im Projekt. Jede Datei wird lokal abgelegt, jede Quelle im Bildnachweis notiert. Nichts wird von fremden Servern eingebunden.
Er greift von selbst, sobald es um Farben, Logo, Radien, Abstände, Animationen oder Bilder geht. Das ausführliche Kapitel dazu ist Design anpassen.
Der Akzent soll ein dunkles Grün werden. Ändere die Tokens, zieh den dunklen Modus, das Favicon und den Styleguide mit und prüf danach die Kontraste in beiden Modi.
Tausch das Portrait im Hero gegen mein eigenes Foto, es liegt unter [Dateiname]. Schneid es passend zu, lösch die alte Datei und trag die Quelle im Bildnachweis nach.
Was er bewusst nicht tut. Er führt keine zweite Schriftfamilie und keine zweite Akzentfarbe ein und repariert Farbfehler nie an einzelnen Stellen, sondern immer an der zentralen Quelle.
Copywriting · Ton und Länge #
Der Skill für jedes Wort auf deiner Website. Er kennt den Ton deines Templates, die Anrede, das Vokabular deiner Nische und die Textlängen, die das Layout verträgt.
Die Längen sind der unterschätzte Teil. Eine Überschrift mit vierzehn Wörtern bricht auf dem Handy in fünf Zeilen um und zerlegt den Hero. Deshalb arbeitet der Skill mit festen Rahmen. Überschriften 3 bis 8 Wörter, Sektionstexte 2 bis 4 Sätze, Antworten in den Fragen und Antworten höchstens 4 Sätze. Wer mehr zu sagen hat, schreibt einen Artikel.
- Erst verstehen, dann schreiben. Wer liest das, was soll die Person danach tun, was hält sie zurück? Ohne diese Antworten keine Überschrift.
- Nutzen vor Eigenschaft. Nicht der Name der Methode überzeugt, sondern was sich für den Kunden ändert.
- Konkret schlägt vollständig. Ein präzises Beispiel wirkt stärker als drei allgemeine Aussagen.
- Laut lesen. Nach jeder Textrunde. Was gesprochen holprig klingt, wird umgeschrieben.
Er greift von selbst, sobald du Texte schreiben, umschreiben oder kürzen lässt, von der Überschrift über die Beschriftung eines Knopfes bis zum Blogbeitrag. Das ganze Kapitel dazu ist Texte und Inhalte.
Schreib die Startseite auf meine [Nische] um. Halte den Ton der Vorlage und die vorgegebenen Textlängen ein und erfinde keine Zahlen oder Auszeichnungen.
Die Antwort zu den Kosten ist zu lang und zu vage. Kürz sie auf höchstens vier Sätze, nenn den Preis offen und schließ mit dem nächsten Schritt ab.
Was er bewusst nicht tut. Er dichtet keine Zahlen, Zitate oder Auszeichnungen dazu. Fehlt Substanz, wird die Sektion kleiner statt die Aussage größer.
SEO · Gefunden werden #
Der Skill für alles, was zwischen deiner Website und einer Suchanfrage steht. Er setzt Seitentitel und Beschreibungen, achtet auf die Struktur der Überschriften, pflegt die maschinenlesbaren Angaben und legt neue Artikel suchmaschinensauber an.
- Ein Thema pro Seite. Jede Seite bekommt genau einen Schwerpunkt. Zwei Seiten auf dasselbe Thema stehen sich gegenseitig im Weg.
- Feste Längen. Titel 50 bis 60 Zeichen, Beschreibungen 120 bis 155 Zeichen, aktiv formuliert und mit dem nächsten Schritt am Ende.
- Interne Links sind Pflicht. Artikel verweisen auf Leistungen, Leistungen aufeinander und auf den Kontakt.
- Lokale Suche. Deine Stadt steht im Titel, in der Überschrift, in den Antworten und in den strukturierten Daten. Name, Adresse und Telefon sind überall identisch.
- Der Domainwechsel hat drei Stellen. Konfiguration, Steuerdatei für Suchmaschinen und die zentrale Datendatei. Der Skill kennt alle drei.
Er greift von selbst bei Titeln und Beschreibungen, beim Wechsel von Stadt oder Domain, beim Anlegen eines Artikels und bei jeder Frage, wie du für etwas gefunden wirst. Das ganze Kapitel dazu ist SEO und Sichtbarkeit.
Stell alle Seitentitel und Beschreibungen von [Stadt A] auf [Stadt B] um. Prüf danach, dass jeder Titel unter 60 Zeichen und jede Beschreibung zwischen 120 und 155 Zeichen liegt.
Ich will für [Suchbegriff] gefunden werden. Sag mir, welche Seite dieses Thema trägt, was ihr dafür fehlt und welche internen Links darauf zeigen sollten.
Was er bewusst nicht tut. Er häuft keine Suchbegriffe, erfindet keine Bewertungssterne und setzt keine strukturierten Daten für Inhalte, die auf der Seite nicht sichtbar sind.
Qualitätsprüfung · Der Prüflauf #
Der Skill, der am Ende jeder Runde steht. Er prüft mit festen Grenzwerten statt nach Gefühl und arbeitet in zwei Stufen. Ein kurzer Durchlauf nach jeder Änderung, eine lange Liste vor dem Livegang.
Nach jeder Änderung
- Der Bauvorgang läuft fehlerfrei durch.
- Jede geänderte Seite wird bei 1440 und bei 390 Pixeln angesehen.
- Jede geänderte Seite wird im hellen und im dunklen Modus angesehen.
- Die Fehlerkonsole des Browsers bleibt leer.
- Bei reduzierter Bewegung sind alle Inhalte sichtbar.
- Interne Links führen irgendwohin, jeder Bildpfad zeigt auf eine Datei.
Vor dem Livegang
Zusätzlich kommt der lange Block. Er enthält die Grenzwerte für Geschwindigkeit, den Durchgang zur Barrierefreiheit mit Tastaturbedienung, Kontrasten und 200 Prozent Zoom, den Test des Formulars, die Prüfung von Titeln und Beschreibungen und den Nachweis, dass von der Beispiel-Identität nichts übrig ist. Die vollständige Liste steht im Kapitel Live gehen.
Prüf bitte, ob nach den Änderungen alles noch stimmt. Bauvorgang, beide Bildschirmbreiten, beide Farbmodi, Fehlerkonsole und interne Links.
Wir gehen morgen live. Lauf die komplette Prüfliste inklusive Livegangs-Block durch und gib mir alle Funde nach Dringlichkeit sortiert.
Der Bauvorgang schlägt fehl. Finde die Ursache, behebe sie und erklär mir danach in einfachen Worten, was sie ausgelöst hat.
Ein Prüflauf vor jedem Hochladen kostet dich eine Minute und fängt kaputte Links, fehlende Bilder und Kontrastprobleme ab, bevor deine Besucher sie sehen. Es ist die Gewohnheit, die aus einer guten Website eine verlässliche macht.
Was er bewusst nicht tut. Er entscheidet nicht, ob eine Aussage wahr ist. Er findet die Stelle, an der eine Zahl oder eine Kundenstimme steht, und du lieferst den Beleg oder streichst sie.
Wie die Skills zusammenspielen #
Die meisten Vorhaben berühren mehrere Skills. Eine neue Unterseite braucht ein Gerüst, Texte, einen Titel und einen Prüflauf. Das ist keine Arbeit für dich, sondern eine Reihenfolge, die deine KI von selbst einhält. Du beschreibst weiterhin nur das Ziel.
| Dein Vorhaben | Die Kette dahinter |
|---|---|
| Der erste Tag | start sammelt in vier Runden ein, template-aufbau baut systematisch weiter, qualitaetspruefung schließt ab. |
| Eine neue Unterseite | template-aufbau legt die Seite im bestehenden Aufbau an, copywriting schreibt die Texte, seo setzt Titel, Beschreibung und interne Links, qualitaetspruefung prüft. |
| Ein neuer Blogbeitrag | seo wählt die Suchfrage und legt die Metadaten an, copywriting schreibt den Artikel nach Muster, qualitaetspruefung prüft Links, Bild und Datumsangaben. |
| Neue Markenfarbe | design-system ändert die Tokens samt dunklem Modus, Favicon und Styleguide, qualitaetspruefung misst die Kontraste in beiden Modi. |
| Umzug in eine andere Stadt | template-aufbau tauscht Adresse und Kontaktdaten, seo zieht Titel, Beschreibungen und strukturierte Daten nach, copywriting glättet die Textstellen, qualitaetspruefung führt den Null-Treffer-Beweis. |
| Kurz vor dem Livegang | qualitaetspruefung allein, mit dem langen Block. Alles andere ist dann bereits erledigt. |
Du gewinnst etwas, wenn du eine Kette einmal ausschreibst. Nicht weil deine KI es sonst nicht könnte, sondern weil du damit die Reihenfolge festlegst und nach jedem Schritt kurz gegenlesen kannst.
Ich brauche eine neue Leistungsseite für [Leistung]. Geh der Reihe nach vor. Erst die Seite im bestehenden Aufbau anlegen, dann die Texte schreiben, dann Titel, Beschreibung und interne Links setzen, zum Schluss der Prüflauf. Sag mir nach jedem Schritt kurz Bescheid.
Wenn die KI den falschen Weg nimmt #
Das passiert, und es ist kein Drama. Meist liegt es daran, dass der Auftrag mehr Spielraum ließ, als du dachtest. Drei Handgriffe lösen fast jeden Fall.
Konkreter werden
Nenn das Ziel, den Ort und die Grenze. Aus „mach die Startseite besser“ wird „kürz die Überschrift im Hero auf höchstens sechs Wörter und lass den Rest der Seite unangetastet“. Je enger der Auftrag, desto genauer das Ergebnis.
Den Skill beim Namen nennen
Dafür stehen die Namen in diesem Kapitel. „Nimm dafür den Skill design-system“ oder „Lauf einmal die Qualitätsprüfung“ bringt deine KI zurück auf die Spur, wenn sie am Playbook vorbeigearbeitet hat.
Zwischenstand prüfen lassen
Vor größeren Umbauten lohnt sich eine Ansage vorab. Lass dir in drei Sätzen erklären, was passieren soll und welche Dateien betroffen sind, und gib dann dein Ja. Das kostet eine halbe Minute und spart im Zweifel eine Stunde.
Bevor du etwas änderst, sag mir in drei Sätzen, was du vorhast und welche Dateien du anfasst. Warte auf mein Ja.
Nimm die letzte Änderung an [Datei oder Bereich] zurück und lass alles andere so, wie es ist. Zeig mir danach, was jetzt wieder anders aussieht.
| Das erlebst du | Das hilft |
|---|---|
| Zu viel geändert | Grenze mitgeben. „Ändere nur diese eine Sektion, alles andere bleibt.“ Danach die letzte Änderung gezielt zurücknehmen lassen. |
| Der Ton trifft nicht | Auf copywriting verweisen und ein Beispiel geben, das dir gefällt. Zwei Sätze im richtigen Ton wirken besser als jede Beschreibung. |
| Nur ein Farbmodus stimmt | Auf design-system verweisen und ausdrücklich beide Modi verlangen. Farbänderungen brauchen immer beide Seiten der Medaille. |
| Die Antwort bleibt allgemein | Nach der konkreten Datei und Zeile fragen. „Zeig mir die Stelle“ führt schneller zum Ziel als „wie geht das“. |
| Das Gespräch wird ungenau | Nach vielen Nachrichten den Stand zusammenfassen lassen und ein neues Gespräch beginnen. Die Skills liegen im Projekt und gelten dort weiter. |
| Etwas ist kaputt | Die Qualitätsprüfung laufen lassen und beschreiben, was du zuletzt getan hast. Der Skill sucht mit Grenzwerten statt mit Vermutungen. |
Bevor du einen Markenwechsel oder einen kompletten Textdurchgang anstößt, leg eine Kopie deines Projektordners an. Dann ist jeder Rückweg eine Frage von Sekunden. Wie du das dauerhaft löst, steht im Kapitel Pflegen und erweitern.
Beschreib dein Ziel in einem Satz, so konkret wie möglich. Der passende Skill greift von allein. Läuft etwas anders als gedacht, nenn den Skill beim Namen und zieh die Grenze enger. Mehr Bedienung braucht es nicht.