scaffold-exercises

Überblick über die scaffold-exercises-Skill

Die scaffold-exercises-Skill hilft einem Agenten dabei, Übungsordner-Strukturen zu erstellen, die einer strikten Trainings-Content-Konvention entsprechen: nummerierte Abschnitte, nummerierte Übungen, Varianten-Unterordner wie problem/, solution/ und explainer/ sowie minimale Dateien, die valide genug sind, um lint-orientierte Checks zu bestehen. Wenn du Kursmaterial, Workshop-Übungen oder ein strukturiertes Lern-Repo aufbaust, löst scaffold-exercises genau dieses praktische Problem.

Wofür scaffold-exercises am besten geeignet ist

Nutze scaffold-exercises, wenn dein Lernplan bereits feststeht und du das Dateisystem-Gerüst korrekt, schnell und konsistent anlegen musst. Besonders geeignet ist es für:

• das Anlegen eines neuen Kursabschnitts unter exercises/
• das Erstellen mehrerer Übungs-Stubs aus einer Curriculum-Gliederung
• das Hinzufügen von Varianten wie problem, solution oder explainer, ohne Namensregeln raten zu müssen
• das Vermeiden fehlerhafter Starter-Verzeichnisse, die später beim Repo-Linting scheitern

Wer scaffold-exercises installieren sollte

Am besten passt die Skill für Personen, die in einem Repo mit einer bereits etablierten, übungsbasierten Lehrstruktur arbeiten. Die scaffold-exercises skill ist besonders nützlich für Maintainer, Curriculum-Autor:innen und KI-gestützte Repo-Editor:innen, die vor allem korrekte Pfade und Datei-Platzhalter brauchen und weniger Textgenerierung.

Was scaffold-exercises von einem generischen Prompt unterscheidet

Ein normaler Prompt kann einer KI sagen: „Erstelle ein paar Übungsordner“, aber scaffold-exercises bringt repo-spezifische Disziplin mit:

• Abschnittsordner verwenden XX-section-name
• Übungsordner verwenden XX.YY-exercise-name
• Namen sind in dash-case
• jede Übung braucht mindestens einen Variantenordner
• jede Variante braucht ein nicht-leeres readme.md
• Code-Dateien wie main.ts werden nur gebraucht, wenn tatsächlich Code vorhanden ist

Das bedeutet: weniger fehlerhafte Pfade, weniger leere Platzhalter und weniger Nacharbeit nach der Generierung.

Die wichtigste Frage vor der Einführung

Installiere scaffold-exercises, wenn dein größtes Risiko strukturelle Abweichungen sind und nicht fehlende inhaltliche Originalität. Diese Skill dreht sich um Scaffolding, das Konventionen einhält. Sie ist kein vollständiger Curriculum-Planer, Lesson-Writer oder Code-Generator.

So verwendest du die scaffold-exercises-Skill

Wie die Installation von scaffold-exercises typischerweise funktioniert

Der Repo-Ausschnitt veröffentlicht in SKILL.md keinen eigenen Custom-Installer, daher hängt die Nutzung von deiner Skills-Runtime ab. In Skills-basierten Setups fügen Teams üblicherweise das Quell-Repo hinzu und rufen dann die scaffold-exercises-Skill per Namen auf. Falls deine Umgebung das unterstützt, ist dieses Muster verbreitet:

npx skills add mattpocock/skills --skill scaffold-exercises

Wenn deine Agent-Plattform Skills anders lädt, verweise sie auf das Repository mattpocock/skills und wähle scaffold-exercises aus.

Diese Datei solltest du vor scaffold-exercises zuerst lesen

Starte mit:

• scaffold-exercises/SKILL.md

Diese Skill ist einfach und in sich geschlossen. In der Repository-Vorschau sind keine zusätzlichen rules/, resources/ oder Helper-Skripte sichtbar, daher steckt der Großteil des relevanten Verhaltens direkt in dieser einen Datei.

Welche Eingaben scaffold-exercises von dir braucht

Die Skill funktioniert am besten, wenn du einen Plan mit vier Punkten vorgibst:

1. die Abschnittsnummer und den Titel
2. die Übungsnummern und Übungstitel
3. welche Varianten jede Übung enthalten soll
4. ob du nur Stubs oder echten Starter-Code willst

Ohne diese Angaben kann der Agent zwar trotzdem scaffolden, wird aber Defaults setzen, die du möglicherweise nicht willst — besonders bei der Entscheidung zwischen explainer/ und problem/.

Der minimale Prompt, der funktioniert

Ein grober, aber brauchbarer scaffold-exercises usage-Prompt sieht so aus:

Use scaffold-exercises to create section 03-search-fundamentals under exercises/. Add exercises 03.01-tokenization-basics and 03.02-bm25-ranking. Each should have problem/ and solution/ folders with non-empty readme.md files. Stub only, no code yet.

Das reicht aus, weil Nummerierung, Namen, Speicherort und Variantentypen angegeben sind.

Ein stärkerer scaffold-exercises-Prompt für bessere Ergebnisse

Ein besserer Prompt macht die Defaults explizit:

Use scaffold-exercises for Skill Scaffolding in this repo. Create exercises/03-search-fundamentals/. Add:

• 03.01-tokenization-basics with explainer/
• 03.02-bm25-ranking with problem/ and solution/
• 03.03-query-expansion with problem/

For each variant, create a non-empty readme.md with the final exercise title and a one-sentence description. Do not add main.ts unless the variant includes code. Keep all names dash-case.

Warum das besser funktioniert:

• Unklarheiten bei den Ordner-Varianten entfallen
• unnötige Code-Dateien werden vermieden
• Namenskonventionen werden von Anfang an festgelegt
• dem Agenten wird konkret gesagt, was „non-empty“ praktisch bedeuten soll

Welches Default-Verhalten du bei unvollständigem Plan von scaffold-exercises erwarten solltest

Eines der wichtigsten Details der Upstream-Skill: Beim Stub-Scaffolding ist explainer/ der Standard, sofern der Plan nichts anderes vorgibt. Das ist für konzeptionelle Übungen nützlich, kann aber falsch sein, wenn du eigentlich Arbeitsbereiche für Lernende brauchst. Wenn du praktische Aufgaben willst, nenne problem/ ausdrücklich.

Was scaffold-exercises erstellt

Die Skill ist auf ein wiederholbares Verzeichnis-Muster ausgerichtet, zum Beispiel:

• exercises/01-section-name/
• exercises/01-section-name/01.01-exercise-name/problem/readme.md
• exercises/01-section-name/01.01-exercise-name/solution/readme.md

Für Stub-Scaffolds sind Ordner, die nur ein Readme enthalten, akzeptabel. Wenn du später Code hinzufügst, sollte main.ts vorhanden sein und mehr als nur einen trivialen Einzeiler enthalten.

Praktischer Workflow für scaffold-exercises in einem echten Repo

Ein guter Ablauf ist:

1. Die Curriculum-Gliederung in einfachem Englisch skizzieren.
2. Daraus nummerierte Abschnitts- und Übungsnamen ableiten.
3. Varianten pro Übung festlegen.
4. Den Agenten scaffold-exercises ausführen lassen.
5. Pfadnamen prüfen, bevor Inhalte ergänzt werden.
6. Den Lint- oder Validierungs-Schritt des Repos ausführen.
7. Erst danach Code und ausführlichere Doku ergänzen.

Diese Reihenfolge ist wichtig, weil die Skill ihre Stärke zuerst bei der Struktur ausspielt.

Welche Benennungsfehler die meiste Nacharbeit verursachen

Die häufigsten schlechten Eingaben sind:

• fehlende numerische Präfixe
• Leerzeichen statt dash-case
• Verwechslung von Abschnittsnummerierung und Übungsnummerierung
• keine Angabe, ob Ordner problem, solution oder explainer sein sollen

Wenn dein Plan nur sagt „Create an exercise on BM25“, muss der Agent immer noch zu viel erfinden. Wenn dein Plan dagegen sagt „Create 01.03-retrieval-with-bm25 inside 01-retrieval-skill-building with problem/ and solution/“, ist das Ergebnis in der Regel zuverlässig.

Eignung von scaffold-exercises für Skill Scaffolding

scaffold-exercises for Skill Scaffolding passt gut, wenn dein Engpass in Repo-Struktur und Konsistenz liegt. Weniger geeignet ist es, wenn du automatisch reichhaltige Didaktik, Assessments oder ausformulierte Erklärungen generieren willst. Betrachte die Skill als Strukturwächter, nicht als Ersatz für Instructional Design.

FAQ zur scaffold-exercises-Skill

Ist scaffold-exercises anfängerfreundlich

Ja — sofern du bereits weißt, welche Übungsstruktur du willst. Die Skill selbst ist einfach: Sie setzt vor allem Benennung, Ordnerlayout und die minimal erforderlichen Dateien durch. Der schwierigere Teil ist, Curriculum und Varianten im Vorfeld sauber festzulegen.

Wann sollte ich scaffold-exercises nicht verwenden

Lass scaffold-exercises aus, wenn:

• dein Repo keine nummerierten Abschnitts- und Übungsordner verwendet
• du nur eine einzelne Markdown-Lesson brauchst und keinen Übungsbaum
• du möchtest, dass die KI die Kursarchitektur von Grund auf erfindet
• dein Projekt einen anderen Datei-Vertrag nutzt als readme.md plus optional main.ts

Wie unterscheidet sich scaffold-exercises vom manuellen Anlegen von Ordnern

Manuelles Scaffolding ist für eine einzelne Übung völlig in Ordnung. Der Mehrwert von scaffold-exercises usage zeigt sich, wenn du viele Übungen anlegst und dabei konsistent bleiben musst. Es reduziert das Risiko ungültiger Namen, leerer Readmes und gemischter Ordnerkonventionen, die nachgelagerte Checks brechen.

Erzeugt scaffold-exercises den vollständigen Übungsinhalt

Nein. Der Kernnutzen ist das Scaffolding. Die Skill kann minimale Readmes und Platzhalterstrukturen erzeugen, sollte aber nicht als vollständiges System zur Lesson-Erstellung verstanden werden.

Brauche ich jedes Mal problem, solution und explainer

Nein. Die Upstream-Regeln verlangen nur, dass mindestens eines davon vorhanden ist. Für Stubs ist explainer/ der Standard, wenn nichts anderes angegeben ist. Wähle die Varianten nach dem Ziel der Übung — nicht aus Gewohnheit.

Ist scaffold-exercises an ein bestimmtes Repo-Layout gebunden

Ja, die Skill ist klar meinungsstark. Sie setzt eine exercises/-Hierarchie und bestimmte Nummerierungskonventionen voraus. Wenn dein Repo diesem Muster folgt, ist sie nützlich. Wenn nicht, wirst du Zeit damit verbringen, gegen ihre Annahmen anzukämpfen.

So verbesserst du die Nutzung der scaffold-exercises-Skill

Gib scaffold-exercises einen nummerierten Plan, keine Themenliste

Der schnellste Weg zu besseren Ergebnissen mit scaffold-exercises ist, nicht mehr mit Themen zu prompten, sondern mit exakten Zielpfaden. Vergleich:

Schwach:

• „Add some exercises about retrieval.“

Stark:

• „Create exercises/01-retrieval-skill-building/01.01-keyword-search, 01.02-bm25, and 01.03-hybrid-search.“

Der zweite Prompt lässt dem Agenten kaum Spielraum, Ordner falsch zu benennen.

Gib die Variantenabsicht an, statt Defaults entscheiden zu lassen

Wenn du Variantentypen weglässt, kann die Skill für Stubs explainer/ wählen. Das ist effizient, passt aber möglicherweise nicht zu deinem didaktischen Design. Formuliere deshalb klar:

• verwende problem/ für Aufgaben für Lernende
• verwende solution/ für Referenzlösungen
• verwende explainer/ für rein konzeptionelles Material

Diese eine Präzisierung verbessert die Scaffold-Qualität spürbar.

Fordere minimale, aber valide Readmes an

Ein häufiger Fehler sind Platzhalter, die technisch vorhanden, aber praktisch unbrauchbar sind. Weise den Agenten an, in jedes readme.md einen Titel und eine Ein-Satz-Beschreibung zu schreiben. So bleiben die Dateien nicht leer und die spätere Ausarbeitung wird einfacher.

Verhindere unnötige Code-Dateien

Ein weiterer häufiger Fehler ist, überall main.ts zu erzeugen. Die Upstream-Skill verlangt das für Readme-only-Stubs nicht. Wenn du ein leichtgewichtiges Scaffold willst, sage ausdrücklich: „readme-only unless code is explicitly needed.“ Das hält den ersten Durchlauf sauberer.

Prüfe Namen, bevor du viele Übungen generieren lässt

Bei größeren Batches solltest du den Agenten zuerst die vorgeschlagenen Pfade auflisten lassen und sie erst nach Freigabe anlegen lassen. So entdeckst du Nummerierungskollisionen und unglückliche Slugs, bevor du dutzende Ordner umbenennen musst.

Iteriere nach dem ersten scaffold-exercises-Durchlauf

Nach dem ersten Lauf verbesserst du die Ergebnisse, indem du Folgendes prüfst:

• durchgängige Nummerierung
• Vollständigkeit der Varianten
• Nützlichkeit der Readmes
• ob jede Übung wirklich in den gewählten Abschnitt gehört

Bitte den Agenten danach um einen zweiten Durchlauf, der sich nur auf Korrekturen konzentriert. Die Qualität eines scaffold-exercises guide steigt merklich, wenn Generierung und Review getrennt werden.

Wo scaffold-exercises weiterhin menschliches Urteilsvermögen braucht

Die scaffold-exercises skill kann dir nicht die richtige Lehrreihenfolge, den Schwierigkeitsgrad von Übungen oder die didaktische Abdeckung abnehmen. Die besten Ergebnisse entstehen, wenn du die Skill zur Automatisierung der Struktur nutzt und die menschliche Prüfung für die Curriculum-Logik behältst.