← DocsMarkdownAnmelden

Agenten-Playbook

Kurze Anweisungen für Coding-Agenten mit MCP.

Du bist mit Skillkren verbunden, einer Bibliothek wiederverwendbarer KI-Skills und Beispiele ihrer Ausgabe. Skills folgen dem offenen Agent Skills-Format: eine SKILL.md (Anweisungen mit name- und description-Frontmatter), plus optionale Dateien in references/, scripts/ und assets/.

Markenname: immer Skillkren. Domain: skillkren.tech.

Erste Schritte

  1. Rufe get_docs mit topic agent auf (oder lies die Resource https://skillkren.tech/docs/agent.md), wenn du eine Auffrischung brauchst.
  2. Nutze list_skills, um die Skills des Nutzers und die Bibliotheken seiner Teams zu prüfen, bevor du Duplikate erstellst. Um den geteilten Skill von jemand anderem zu öffnen, nutze get_skill mit der id aus dem Link.
  3. Im Free-Plan kann ein Nutzer bis zu 25 Skills speichern; upsert_skill gibt am Limit einen Fehler zurück. Umgehe das nicht.
  4. Nutze upsert_skill mit einem klaren Titel. Es aktualisiert deinen eigenen Skill mit diesem Titel, oder erstellt einen neuen. Übergib team, um in einer Team-Bibliothek zu arbeiten.
  5. Hänge beim Veröffentlichen eines neuen Skills immer mindestens ein Beispiel an (add_example).

Einen Skill verwenden

  1. Lade ihn mit get_skill und folge seinen Anweisungen.
  2. get_skill listet gebündelte files nach Pfad. Lies eine mit get_skill_file nur, wenn die Anweisungen darauf verweisen oder die Aufgabe sie braucht.
  3. Nutze die Beispiele des Skills als Referenz für Format, Ton und Qualität.

Einen guten Skill schreiben

  • Beschreibung: was der Skill tut und wann man ihn verwendet, mit den Worten, die ein Nutzer tatsächlich sagen würde. Agents entscheiden allein danach, ob sie einen Skill laden.
  • Anweisungen (content): rohes Markdown, kein HTML. Schritte, Regeln und wie gute Ausgabe aussieht. Halte es unter etwa 500 Zeilen.
  • Referenzen: verschiebe langes Material (Style Guides, API-Notizen, Checklisten) mit put_skill_file nach references/, und nenne jede Datei in den Anweisungen mit ihrem Pfad, z. B. "For banned words, read references/banned-words.md". Vorlagen und Daten gehören in assets/, ausführbarer Code in scripts/.
  • Lizenz: setze license nur (z. B. MIT, Apache-2.0, CC-BY-4.0, Proprietary), wenn der Nutzer eine wählt. Frage nach; wähle nicht für ihn.
  • Anforderungen: setze compatibility nur, wenn der Skill bestimmte Tools oder Zugriff braucht.

Einen Skill-Ordner hochladen

Wenn der Nutzer dich bittet, einen lokalen Skill hochzuladen (zum Beispiel ~/.claude/skills/pdf-processing/):

  1. Lies SKILL.md. Nutze name (als lesbaren Titel), description und license; der Inhalt nach dem Frontmatter ist der content.
  2. Rufe upsert_skill mit diesen Feldern auf. Wenn der Ordner eine LICENSE-Datei hat, übergib ihren Text als licenseText.
  3. Für jede Datei unter references/, scripts/ und assets/ rufe put_skill_file mit demselben relativen Pfad auf, z. B. references/forms.md.
  4. Nur Textdateien bis zu 100 KB je Datei, 30 pro Skill, eine Unterordnerebene tief. Überspringe Binärdateien (Bilder, PDFs) und sage dem Nutzer, welche Dateien du übersprungen hast.
  5. Gib dem Nutzer den Link zum Skill, wenn du fertig bist.

In die andere Richtung kann der Nutzer jeden Skill als Zip von seiner Seite herunterladen und in den Skills-Ordner seiner App entpacken.

Sichtbarkeit

Neue Skills sind Private (nur der Eigentümer). Unlisted-Skills können von jedem mit dem Link geöffnet werden; Public-Skills sind zusätzlich auf dem Profil des Eigentümers unter https://skillkren.tech/u/<username> gelistet.

Du kannst die Sichtbarkeit nicht ändern. Wenn der Nutzer einen Skill teilen will, schicke ihn zu dessen Seite und sage ihm, den Schalter neben dem Titel zu nutzen. Schlage niemals vor, einen Skill mit Geheimnissen darin zu teilen.

Auth-Kontext

Deine Verbindung gehört zu einem Nutzer. Alles, was du erstellst, gehört diesem Nutzer, und du kannst nur ändern, was dieser Nutzer ändern kann.

URLs zum Zitieren

  • App: https://skillkren.tech/app
  • Skill: nutze die url, die die Tools zurückgeben. Sie sieht aus wie https://skillkren.tech/u/<username>/skills/<id>.
  • Beispiele: die Skill-URL plus /examples. Referenzen: die Skill-URL plus /references.
  • Docs: https://skillkren.tech/docs
  • Agent-Doc (roh): https://skillkren.tech/docs/agent.md

Don'ts

  • Lösche keine Skills oder Dateien, es sei denn, der Nutzer bestätigt.
  • Füge keine Geheimnisse in Skills, Dateien oder Beispiele ein.
  • Verlasse dich nicht auf clientseitiges Rendering; speichere Markdown-Quelle.