---
type: types/source.md
source_type: analysis
author: Torben
raw_files: [raw/notes/copilot-skill-restructure-instructions.md]
source_language: en
date: 2026-08-03
tags: [skills, restructure, cross-platform, agents]
entities: [Chemenu, AGENTS.md, wikitool, GitHub Copilot, Claude Code, Codex CLI, Mistral Vibe, awesome-llm-wiki]
concepts: [Cross-platform Agent Skills, Token Economics, Scale Ceiling, Workflow Extraction, Context Isolation]
summary: Anweisungssatz zur Aufteilung der monolithischen AGENTS.md in einzelne plattformübergreifende Agent-Skills
fidelity: unknown
authority: normative
---
# Source: Copilot Skill Restructure Instructions

**Autor:** Torben
**Datum:** 2026-08-03
**Quelle:** raw/notes/copilot-skill-restructure-instructions.md
**Typ:** notes

## Zusammenfassung

Dieses Dokument bietet umfassende Anweisungen zur Umstrukturierung der monolithischen Datei `AGENTS.md` (~30KB) in diskrete, abrufbare Agent-Skills, die identisch in GitHub Copilot (VS Code), Claude Code, Codex CLI und Mistral Vibe funktionieren. Die Umstrukturierung zielt darauf ab, Tokenökonomiefragen und Skalierungsgrenzen zu beheben, indem prozedurale Workflows von deklarativen Regeln getrennt werden, um kontexteffiziente Operationen zu ermöglichen, bei denen für jede Aufgabe nur relevante Anweisungen geladen werden.

Das Dokument beschreibt einen Ziel-Skill-Satz von fünf (optional sechs) eigenständigen Skills: `wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-create`, `wiki-update` und optional `wiki-status`. Jeder Skill soll in sich geschlossen in `.agents/skills/wiki-<name>/SKILL.md` gemäß einer bestimmten Struktur mit den Abschnitten Purpose, Trigger, Steps, wikitool-Befehlen und Output sein. Die Wurzeldatei `AGENTS.md` soll auf deklarativen, übergreifenden Inhalt wie Architektur, Entity-/Concept-Typen, Beziehungstypen, Benennungskonventionen, Provenance-Regeln und Konfidenz-Bewertung reduziert werden.

Das Dokument beschreibt ein plattformübergreifendes Dateien-Layout mit `.agents/skills/` als gemeinsames Verzeichnis, mit werkzeugspezifischen Wiring-Anweisungen für Claude Code, Codex CLI, Mistral Vibe und GitHub Copilot. Es enthält eine Ausführungscheckliste und betont, dass es sich um eine strukturelle Extraktion handelt (keine Umschreibung) - alle Workflow-Schritte, Befehle und Regeln müssen wörtlich beibehalten werden.

## Kernaussagen

- **Tokenökonomiefrage**: Eine auf jede Aufgabe geladene monolithische Anweisungsdatei kostet das 5-8fache der Token-Quellenanzahl, auch für einfache Abfragen. Single-Context-Ansätze verschlechtern sich in Qualität, sobald ein Wiki ~100-200 Seiten überschreitet.
- **Lösungspräzedenz**: Mehrere Ökosystem-Implementierungen (kfchou/wiki-skills, Leo Alexandru's Setup, vanillaflava/wiki-skills-vanillaflava, yugasun/llm-wiki-skills) demonstrieren plattformübergreifende Skill-Verteilung mit Kontextisolation.
- **Zielarchitektur**: Fünf Skills (wiki-ingest, wiki-query, wiki-lint, wiki-create, wiki-update) im Verzeichnis `.agents/skills/`, mit reduzierter Wurzeldatei AGENTS.md, die nur Schema und Richtlinien enthält.
- **Dateien-Layout**: Gemeinsames Verzeichnis `.agents/skills/` mit werkzeugspezifischen Symlinks oder Konfiguration, die darauf verweist.
- **Bewahrungsprinzip**: Dies ist eine verlustfreie Verschiebung - Workflow-Abschnitte wörtlich aus AGENTS.md in Skill-Dateien extrahieren, jeden nummerierten Schritt, wikitool-Befehl und jede Regel bewahren.

## Aufgaben

- [ ] `.agents/skills/wiki-ingest/SKILL.md` bis `.agents/skills/wiki-update/SKILL.md` erstellen
- [ ] Workflow-Abschnitte wörtlich aus AGENTS.md in entsprechende Skill-Dateien extrahieren
- [ ] Wurzeldatei AGENTS.md umschreiben, um nur deklarativen Inhalt zu enthalten (Architektur, Entity-/Concept-Typen, Beziehungstypen, Seitenformate, Benennungskonventionen, Provenance-Regeln, Konfidenz-Bewertung, Qualitätsstandards, IT-spezifische Richtlinien, Wartungsplan, Nutzerpräferenzen, Versionshistorie)
- [ ] Abschnitt „Skills" oben in der Wurzeldatei AGENTS.md hinzufügen, der die fünf Skill-Namen mit einzeiligen Zwecken auflistet
- [ ] `.vscode/settings.json` mit `chat.agentSkillsLocations`-Eintrag erstellen/aktualisieren
- [ ] Verifizieren, dass kein Workflow-Schritt, wikitool-Aufruf oder Regel während der Extraktion verloren ging
- [ ] Versionstabelle in AGENTS.md mit neuer Zeile zur Beschreibung dieser Umstrukturierung aktualisieren

## Verwandte Entities

- [[Chemenu]]
- [[AGENTS.md]]
- [[wikitool]]
- [[GitHub Copilot]]
- [[Claude Code]]
- [[Codex CLI]]
- [[Mistral Vibe]]
- [[awesome-llm-wiki]]
- [[wiki-skills]]
- [[wiki-skills-vanillaflava]]
- [[llm-wiki-skills]]

## Verwandte Concepts

- [[Cross-platform Agent Skills]]
- [[Token Economics]]
- [[Scale Ceiling]]
- [[Workflow Extraction]]
- [[Context Isolation]]