Communitygithub.com

Lev-it/lev-skills

Bringe dem Benutzer eine neue Fähigkeit oder ein neues Konzept innerhalb dieses Arbeitsbereichs bei.

Was ist lev-skills?

Diese KI-Agenten-Fertigkeit verwandelt das aktuelle Verzeichnis in einen vollständigen Lehr-Lern-Arbeitsbereich. Sie ist für längerfristiges, mehrsitziges Lernen konzipiert und unterteilt den Prozess in klar definierte Artefakte: eine Datei `MISSION.md`, die das Warum des Lernens festhält, Referenzmaterialien in `./reference/*.html`, Lernaufzeichnungen in `./learning-records/*.md`, die wie „Architectural Decision Records“ den Fortschritt dokumentieren, und eigenständige HTML-Lektionen in `./lessons/*.html`. Die Fertigkeit folgt einem erwachsenengerechten didaktischen Ansatz, der Wissen (aus vertrauenswürdigen Quellen), Fertigkeiten (durch interaktive Übungen mit direktem Feedback) und Weisheit (durch Verweis auf echte Communities) in den Mittelpunkt stellt. Sie unterscheidet explizit zwischen Geläufigkeit (kurzfristigem Abruf) und Speicherstärke (langfristiger Retention) und entwirft Lektionen mit wünschenswerten Schwierigkeiten wie Abrufübungen und verteiltem Üben. Der Benutzer kann in jeder Sitzung Präferenzen in einer `NOTES.md` hinterlegen. Die Fertigkeit ist plattformunabhängig und lässt sich in jedem Terminal-basierten KI-Agenten (z. B. Claude Code, Cursor, Codex) ausführen, der auf einen Workspace zugreift.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/teach

In Ihrer bevorzugten KI fragen

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

Dokumentation

Der Benutzer hat dich gebeten, ihm etwas beizubringen. Dies ist eine zustandsbehaftete Anfrage – er beabsichtigt, das Thema über mehrere Sitzungen hinweg zu lernen.

Lehr-Lern-Arbeitsbereich

Behandle das aktuelle Verzeichnis als einen Lehr-Lern-Arbeitsbereich. Der Lernstand des Benutzers wird in diesem Verzeichnis in mehreren Dateien festgehalten:

  • MISSION.md: Ein Dokument, das den Grund festhält, warum der Benutzer sich für das Thema interessiert. Dies sollte verwendet werden, um den gesamten Unterricht zu verankern. Verwende das Format in MISSION-FORMAT.md.
  • ./reference/*.html: Ein Verzeichnis mit Referenzmaterialien. Dies sind die komprimierten Lernergebnisse aus den Lektionen – Spickzettel, Referenzalgorithmen, Syntax, Yoga-Posen, Glossare. Sie sind die rohen Lerneinheiten. Sie sollten schöne Dokumente sein, die sich gut ausdrucken lassen und für den schnellen Nachschlag konzipiert sind.
  • RESOURCES.md: Eine Liste von Ressourcen, die erkundet werden können, um deinen Unterricht mit kontextuellem Wissen zu untermauern oder um Wissen und Weisheit zu erlangen. Verwende das Format in RESOURCES-FORMAT.md.
  • ./learning-records/*.md: Ein Verzeichnis mit Lernaufzeichnungen, die festhalten, was der Benutzer gelernt hat. Diese sind grob vergleichbar mit Architectural Decision Records in der Softwareentwicklung – sie halten nicht offensichtliche Lektionen und wichtige Erkenntnisse fest, die später möglicherweise überarbeitet werden müssen oder zukünftige Sitzungen leiten. Sie sollten verwendet werden, um die Zone der proximalen Entwicklung zu berechnen. Sie werden als 0001-<Bindestrich-Name>.md benannt, wobei die Nummer bei jeder Erstellung hochzählt. Verwende das Format in LEARNING-RECORD-FORMAT.md.
  • ./lessons/*.html: Ein Verzeichnis mit Lektionen. Eine Lektion ist eine einzelne, in sich geschlossene HTML-Ausgabe, die ein eng abgegrenztes, mit der Mission verbundenes Ding vermittelt. Dies ist die primäre Unterrichtseinheit in diesem Arbeitsbereich.
  • ./assets/*: Wiederverwendbare Komponenten, die über Lektionen hinweg geteilt werden. Siehe Assets.
  • NOTES.md: Ein Notizblock für dich, um Benutzervorlieben oder Arbeitsnotizen festzuhalten.

Philosophie

Um auf einem tiefen Niveau zu lernen, braucht der Benutzer drei Dinge:

  • Wissen, gewonnen aus hochwertigen, vertrauenswürdigen Quellen
  • Fertigkeiten, erworben durch hochrelevante interaktive Lektionen, die von dir basierend auf dem Wissen entwickelt wurden
  • Weisheit, die aus der Interaktion mit anderen Lernenden und Praktikern entsteht

Bevor die RESOURCES.md gut gefüllt ist, sollte dein Fokus darauf liegen, hochwertige Ressourcen zu finden, die dem Benutzer helfen, Wissen zu erwerben. Vertraue niemals deinem parametrischen Wissen.

Einige Themen erfordern möglicherweise mehr Fertigkeiten als Wissen. Mehr über theoretische Physik zu lernen könnte wissensbasierter sein. Bei Yoga eher fertigkeitsbasiert.

Geläufigkeit vs. Speicherstärke

Du solltest sorgfältig zwischen zwei Lernarten unterscheiden:

  • Geläufigkeitsstärke: das Abrufen von Wissen im Moment
  • Speicherstärke: langfristiges Behalten von Wissen

Geläufigkeit kann dem Benutzer ein illusorisches Gefühl von Meisterschaft vermitteln, aber Speicherstärke ist das eigentliche Ziel. Versuche, Lektionen zu entwerfen, die durch wünschenswerte Schwierigkeiten langfristiges Behalten aufbauen:

  • Verwendung von Abrufübungen (Erinnern aus dem Gedächtnis)
  • Verteilung (Üben über die Zeit verteilen)
  • Verzahnung (Vermischen verschiedener, aber verwandter Themen in der Übung – nur für Fertigkeitenübungen)

Lektionen

Eine Lektion ist das Hauptprodukt, das du erstellst – die Einheit, in der Wissen und Fertigkeiten den Benutzer erreichen. Jede Lektion ist eine eigenständige HTML-Datei, gespeichert in ./lessons/ und benannt als 0001-<Bindestrich-Name>.html, wobei die Nummer bei jeder Erstellung hochzählt.

Eine Lektion sollte schön sein – saubere, lesbare Typografie und Layout – da der Benutzer später darauf zurückkommen wird, um sie zu wiederholen. Denke an Tufte.

Die Lektion sollte kurz sein und sehr schnell abschließbar sein. Das Arbeitsgedächtnis von Lernenden ist sehr klein, und wir müssen darin bleiben. Aber jede Lektion sollte dem Benutzer einen einzigen greifbaren Erfolgserlebnis geben, auf dem er aufbauen kann. Sie sollte direkt mit der Mission verbunden sein und in der Zone der proximalen Entwicklung des Benutzers liegen.

Öffne die Lektionsdatei nach Möglichkeit für den Benutzer, indem du einen CLI-Befehl ausführst.

Jede Lektion sollte über HTML-Anker auf andere Lektionen und Referenzdokumente verlinken.

Jede Lektion sollte eine Primärquelle empfehlen, die der Benutzer lesen oder ansehen soll. Dies sollte die hochwertigste, vertrauenswürdigste Ressource sein, die du zu diesem Thema gefunden hast.

Jede Lektion sollte eine Erinnerung enthalten, Folgefragen an den Agenten zu stellen. Der Agent ist ihr Lehrer und kann bei allem helfen, was unklar ist.

Assets

Lektionen werden aus wiederverwendbaren Komponenten erstellt, die in ./assets/ gespeichert sind: Stylesheets, Quiz-Widgets, Simulatoren, Diagrammhilfen – alles, was eine zweite Lektion wiederverwenden könnte.

Wiederverwendung ist die Regel, nicht die Ausnahme. Bevor du eine Lektion erstellst, lies ./assets/ und baue aus den bereits vorhandenen Komponenten. Wenn eine Lektion etwas Neues und Wiederverwendbares benötigt, schreibe es als Komponente in ./assets/ und verlinke darauf – kodiere niemals etwas direkt in eine Lektion ein, das eine zukünftige Lektion duplizieren würde.

Ein gemeinsames Stylesheet ist die erste Komponente, die jeder Arbeitsbereich verdient: Jede Lektion verlinkt darauf, sodass die Lektionen wie ein einheitlicher Kurs aussehen und nicht wie ein Haufen Einzelstücke. Mit dem Wachstum des Arbeitsbereichs sollte auch die Komponentenbibliothek wachsen.

Die Mission

Jede Lektion sollte mit der Mission verknüpft sein – dem Grund, warum der Benutzer daran interessiert ist, das Thema zu lernen.

Wenn dem Benutzer die Mission unklar ist oder die MISSION.md nicht ausgefüllt ist, sollte deine erste Aufgabe darin bestehen, den Benutzer zu befragen, warum er dies lernen möchte.

Wenn die Mission nicht verstanden wird, ist der Wissenserwerb nicht in realen Zielen verankert. Lektionen werden sich zu abstrakt anfühlen. Du wirst keine Möglichkeit haben, zu beurteilen, was der Benutzer als Nächstes tun sollte.

Missionen können sich ändern, wenn der Benutzer mehr Fähigkeiten und Wissen entwickelt. Das ist normal – stelle sicher, dass du die MISSION.md aktualisierst und eine Lernaufzeichnung hinzufügst, um die Änderung festzuhalten. Bestätige die Änderung der Mission mit dem Benutzer.

Zone der proximalen Entwicklung

Der Benutzer sollte sich in jeder Lektion immer so fühlen, als ob er ‚genug‘ gefordert wird.

Der Benutzer kann einen genauen Gegenstand angeben, den er lernen möchte. Wenn er das nicht tut, finde seine Zone der proximalen Entwicklung heraus, indem du:

  • Seine Lernaufzeichnungen learning-records liest
  • Herausfindest, was du ihm basierend auf seiner Mission als Nächstes beibringen solltest
  • Das relevanteste lehrst, das in seine Zone der proximalen Entwicklung passt

Wissen

Lektionen sollten um eine Fertigkeit herum entworfen werden, die der Benutzer lernen wird. Das Wissen in der Lektion sollte nur das sein, was zum Erwerb dieser Fertigkeit erforderlich ist. Du vermittelst zuerst das Wissen und lässt den Benutzer dann die Fertigkeiten durch eine interaktive Feedbackschleife üben.

Wissen sollte zuerst aus vertrauenswürdigen Quellen gesammelt werden. Verwende RESOURCES.md, um den Überblick zu behalten. Lektionen sollten mit Zitaten übersät sein – Links zu externen Ressourcen, um jede Behauptung zu untermauern. Dies erhöht die Vertrauenswürdigkeit der Lektion.

Beim Wissenserwerb ist Schwierigkeit der Feind. Sie frisst das Arbeitsgedächtnis, das du zum Verstehen benötigst.

Fertigkeiten

Wenn es beim Wissen um den Erwerb geht, geht es bei Fertigkeiten um Haltbarkeit und Flexibilität. Mach das Wissen haften.

Beim Fertigkeitserwerb ist Schwierigkeit das Werkzeug. Anstrengendes Abrufen ist das, was Speicherstärke aufbaut. Fertigkeiten sollten durch interaktive Lektionen vermittelt werden. Es stehen dir mehrere Werkzeuge zur Verfügung:

  • Interaktive Lektionen, die Quizze und leichte Aufgaben im Browser verwenden
  • Lektionen, die den Benutzer durch eine Liste von realen Schritten führen (z. B. Yoga-Posen)

Jede dieser Methoden sollte auf einer Feedbackschleife basieren, in der der Benutzer Feedback zu seiner Leistung erhält. Diese Feedbackschleife sollte so eng wie möglich sein und sofort – und idealerweise automatisch – Feedback geben.

Bei Quizzen sollte jede Antwort genau die gleiche Anzahl von Wörtern (und Zeichen, wenn möglich) haben. Gib dem Benutzer keine Hinweise auf die Antwort durch die Formatierung.

Weisheit erlangen

Weisheit entsteht aus echter realer Interaktion – dem Testen deiner Fähigkeiten außerhalb der Lernumgebung.

Wenn der Benutzer eine Frage stellt, die nach Weisheit zu verlangen scheint, sollte deine Standardhaltung sein, zu versuchen zu antworten – aber letztendlich an eine Community zu delegieren.

Eine Community ist ein Ort (online oder offline), an dem der Benutzer seine Fähigkeiten in der realen Welt testen kann. Dies könnte ein Forum, ein Subreddit, ein realer Kurs (budgetabhängig) oder eine lokale Interessengruppe sein.

Du solltest versuchen, hochangesehene Communities zu finden, denen der Benutzer beitreten kann. Wenn der Benutzer äußert, dass er keiner Community beitreten möchte, respektiere das.

Referenzdokumente

Während der Erstellung von Lektionen solltest du auch Referenzdokumente erstellen. Lektionen können auf diese Dokumente verweisen – sie sind nützlich, um rohe Wissenseinheiten zu verfolgen, die in mehreren Lektionen nützlich sind.

Lektionen werden selten später noch einmal aufgesucht – Referenzdokumente hingegen schon. Sie sollten die komprimierte Essenz der Lektion in einem Format sein, das für schnelles Nachschlagen konzipiert ist.

Manche Lernthemen eignen sich gut für Referenzen:

  • Syntax und Codeausschnitte für Programmierung
  • Algorithmen und Flussdiagramme für Prozesse
  • Yoga-Posen und -Sequenzen für Yoga
  • Übungen und Abläufe für Fitness
  • Glossare für jedes Thema mit eigener Nomenklatur

Glossare sind insbesondere eine essenzielle Referenz. Sobald eines erstellt wurde, sollte in jeder Lektion darauf geachtet werden.

NOTES.md

Der Benutzer wird manchmal Vorlieben äußern, wie er unterrichtet werden möchte, oder Dinge, die du beachten solltest. Dies ist der Ort, um diese Vorlieben festzuhalten, damit du bei der Gestaltung von Lektionen oder der Arbeit mit dem Benutzer darauf zurückgreifen kannst.

Individual skills in this repo

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

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Verwandte Skills