promote

Überblick über den promote skill

Was promote macht

Der promote skill macht aus einem wiederholten, bewährten Claude-Verhalten aus dem Auto-Memory eine explizite Projektregel. Statt ein nützliches Muster in MEMORY.md verborgen zu lassen, hilft promote dabei, es nach CLAUDE.md, .claude/rules/<topic>.md oder in eine globale Claude-Instruktionsdatei zu übertragen, damit das Verhalten in künftigen Sessions zuverlässig angewendet wird.

Am besten geeignet für selbstverbessernde Claude-Workflows

Verwenden Sie promote, wenn Ihr Team Claude bereits aus Korrekturen, Präferenzen und wiederkehrenden Projektkonventionen lernen lässt, nun aber eine dieser Erkenntnisse dauerhaft machen möchte. Besonders nützlich ist der skill in Context-Engineering-Setups, in denen MEMORY.md Beobachtungen sammelt und Regeldateien festlegen, woran sich der Agent verlässlich halten muss.

Gute Beispiele sind „immer pnpm in diesem Repo verwenden“, „API handlers must validate input“ oder „tests for billing code require these fixtures“. Schlechte Beispiele sind einmalige Vorlieben, ungeklärte Diskussionen oder Regeln, die sich in der Praxis noch nicht bewährt haben.

Warum dieser promote skill nützlich ist

Der skill ist nicht einfach nur eine Copy-and-paste-Erinnerung. Er liefert einen Entscheidungsworkflow: Muster klären, passende Memory-Einträge finden, die richtige Zieldatei auswählen, eine durchsetzbare Regel formulieren und den ursprünglichen Memory-Eintrag mit einem Promotion-Hinweis erhalten. Das ist wichtig, weil die eigentliche Schwierigkeit nicht darin liegt, Markdown zu bearbeiten, sondern zu entscheiden, ob ein Memory-Eintrag dauerhafte Verbindlichkeit verdient und wohin die Regel gehört.

So verwenden Sie den promote skill

promote installieren und das Repository gezielt lesen

Installieren Sie den skill aus der GitHub skill collection mit:

npx skills add alirezarezvani/claude-skills --skill promote

Lesen Sie anschließend zuerst SKILL.md. Dieser Repository-Pfad stellt den promote-Workflow derzeit in einer einzigen Datei bereit; es gibt also keine Hilfsskripte, Referenzen oder Regel-Templates, die Sie zusätzlich prüfen müssten. Das macht die Einführung einfach, bedeutet aber auch, dass Sie die Befehlsbeispiele und die Tabelle zur Zielauswahl sorgfältig lesen sollten, bevor Sie den skill in einem wichtigen Repo einsetzen.

Wie Sie promote in der Praxis aufrufen

Der vorgesehene Trigger ist /si:promote, gefolgt von dem Muster, das dauerhaft werden soll:

• /si:promote use pnpm instead of npm
• /si:promote API handlers need validation --target rules/api.md
• /si:promote tests for auth changes must include session expiry cases --target rules/testing.md --paths "src/auth/**/*.ts"

Der skill prüft zuerst, welches Verhalten gemeint ist. Wenn Ihre Anfrage unklar ist, sollte er genau eine klärende Frage stellen, etwa ob die Regel global gilt oder nur für bestimmte Pfade. Danach durchsucht er die Claude-Auto-Memory-Datei des Projekts unter ~/.claude/projects/.../memory/MEMORY.md nach passenden Einträgen, zeigt die Treffer an und bestätigt, dass der Memory-Eintrag die Promotion stützt.

Aus einem groben Ziel einen starken Prompt machen

Ein schwacher Prompt lautet: „promote our testing preference.“ Eine stärkere Verwendung von promote nennt Verhalten, Belege, Geltungsbereich und — falls bekannt — das Ziel:

/si:promote "When changing billing code, add regression tests for failed payment and retry paths" --target rules/testing.md --paths "src/billing/**/*.ts"

Das funktioniert besser, weil der skill daraus eine durchsetzbare Regel statt einer vagen Präferenz formulieren kann. Geben Sie Folgendes an:

• das genaue Verhalten, dem Claude folgen soll
• ob es für das gesamte Projekt, ausgewählte Dateitypen oder alle Projekte gilt
• Beispielpfade, wenn die Regel eingeschränkt ist
• die Memory-Formulierung oder den Vorfall, der gezeigt hat, dass das Muster nützlich ist

Empfohlener Workflow vor dem Mergen der Regel

Nachdem promote eine Regel entworfen oder bearbeitet hat, prüfen Sie sie wie produktive Konfiguration. Achten Sie darauf, dass die Anweisung kurz, überprüfbar und nicht breiter ist, als die Belege rechtfertigen. Für projektweites Verhalten ist CLAUDE.md meistens passend. Für eng begrenztes Verhalten ist .claude/rules/<topic>.md mit Pfad-Scope besser. Für eine persönliche Konvention über mehrere Repositories hinweg sollten Sie eine globale Claude-Instruktionsdatei nur verwenden, wenn das Muster wirklich universell ist.

FAQ zum promote skill

Ist promote für Context Engineering oder allgemeines Prompting gedacht?

Promote ist besonders wertvoll für Context Engineering, weil es den Weg von beobachtetem Verhalten zu dauerhafter Instruktion formalisiert. Allgemeine Prompts können Claude bitten, sich etwas für eine Session zu merken; promote hilft zu entscheiden, ob diese Erkenntnis Teil des operativen Repo-Kontexts werden sollte.

Wann sollte ich promote nicht verwenden?

Verwenden Sie promote nicht für ungeprüfte Ideen, temporäre Workarounds, persönlichen Geschmack, der Teamnormen widerspricht, oder Anweisungen, die eigentlich in Anwendungscode, Tests, Linters oder CI gehören. Eine Regel ist hilfreich, wenn sie Agentenverhalten steuert; sie ist riskant, wenn sie ausführbare Absicherung ersetzt.

Worin unterscheidet sich das vom manuellen Bearbeiten von CLAUDE.md?

Manuelles Bearbeiten kann funktionieren, überspringt aber häufig Belege und Geltungsbereich. Der promote skill ergänzt einen wiederholbaren Prozess: Memory-Eintrag finden, beabsichtigtes Verhalten bestätigen, das richtige Ziel auswählen und nachvollziehbar festhalten, dass der Memory-Eintrag promoted wurde. Das reduziert Regelwildwuchs und hilft künftigen Maintainerinnen und Maintainern zu verstehen, warum die Anweisung existiert.

Ist promote einsteigerfreundlich?

Ja, sofern die Nutzerinnen und Nutzer bereits wissen, wo sich der Claude-Projekt-Memory und die Regeldateien befinden. Einsteiger sollten mit einem einzigen klaren projektweiten Muster beginnen, --target claude.md verwenden und Regeln mit Pfad-Scope vermeiden, bis sie mit den Konventionen in .claude/rules/ vertraut sind.

So verbessern Sie den promote skill

Bessere promote-Ergebnisse durch bessere Belege

Der promote skill funktioniert am besten, wenn der zugrunde liegende Memory-Eintrag konkret ist. Sammeln Sie vor dem Aufruf den exakten Memory-Eintrag, die Korrektur oder den wiederholten Fehler, der zeigt, dass die Regel nötig ist. „Claude keeps using npm“ ist schwächer als „In three sessions Claude ran npm commands, but this repo uses pnpm and has no package-lock.json.“

Häufige Fehler beim Promoten vermeiden

Der häufigste Fehler ist Over-Promotion: Aus einer engen Beobachtung wird ein globaler Befehl. Ein weiterer Fehler sind Regeln, die gut klingen, aber nicht handlungsleitend sind, etwa „write better tests.“ Eine bessere Regel benennt Auslöser, erforderliche Aktion und Geltungsbereich: „For src/api/**/*.ts, validate request bodies before calling service functions.“

Nach der ersten generierten Regel iterieren

Fragen Sie nach der ersten promote-Ausgabe, ob die Regel zu breit, zu vage oder an anderer Stelle bereits vorhanden ist. Verfeinern Sie sie anschließend. Nützliche Folgeprompts sind:

• “Make this rule enforceable in one paragraph.”
• “Narrow this to only API route files.”
• “Add one example and one non-example.”
• “Check whether this belongs in CLAUDE.md or .claude/rules/testing.md.”

Das Regelsystem gesund halten

Ein guter promote-Leitfaden sollte die Regelebene davor schützen, unübersichtlich zu werden. Prüfen Sie promoted rules regelmäßig auf Konflikte, veraltete Konventionen und Anweisungen, die besser in Tooling überführt werden sollten. Das beste promote-Ergebnis ist nicht mehr Markdown, sondern weniger wiederholte Korrekturen, weil Claude den richtigen dauerhaften Kontext im passenden Geltungsbereich erhält.