torben
b138fd8e64
Files changed: - CHANGES.md - VERSION - instructions/dev/corpus-policy.md - instructions/wiki-ingest/SKILL.md - kb/index.md - kb/log.md - kb/sources/COLLECTION.md - kb/sources/INDEX.md - kb/sources/Source - AMD Powermanagement CPU.md - kb/sources/Source - Arch Linux Cheat Sheet.md - kb/sources/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md - kb/sources/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md - kb/sources/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md - kb/sources/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md - kb/sources/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md - kb/sources/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md - kb/sources/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md - kb/sources/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md - kb/sources/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md - kb/sources/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md - kb/sources/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md - kb/sources/Source - Copilot Skill Restructure Instructions.md - kb/sources/Source - Docker Cheatsheet.md - kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md - kb/sources/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md - kb/sources/Source - LLM Improvements Codex Analysis.md - kb/sources/Source - LLM Improvements Production Agent Gaps 2026.md - kb/sources/Source - LLM Improvements Sonnet Analysis.md - kb/sources/Source - LLM Wiki Pattern.md - kb/sources/Source - LLM Wiki v2.md - kb/sources/Source - MCP Read Server Implementation Session 2026-09-02.md - kb/sources/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md - kb/sources/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md - kb/sources/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md - kb/sources/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md - kb/sources/Source - Wine.md - kb/sources/Source - qmd - GitHub Repository.md - kb/sources/analyses/Source - Copilot Skill Restructure Instructions.md - kb/sources/analyses/Source - LLM Improvements Codex Analysis.md - kb/sources/analyses/Source - LLM Improvements Production Agent Gaps 2026.md - kb/sources/analyses/Source - LLM Improvements Sonnet Analysis.md - kb/sources/articles/Source - AMD Powermanagement CPU.md - kb/sources/articles/Source - LLM Wiki Pattern.md - kb/sources/articles/Source - LLM Wiki v2.md - kb/sources/documents/Source - qmd - GitHub Repository.md - kb/sources/notes/Source - Arch Linux Cheat Sheet.md - kb/sources/notes/Source - Docker Cheatsheet.md - kb/sources/notes/Source - Wine.md - kb/sources/trackers/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md - kb/sources/trackers/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md - kb/sources/transcripts/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md - kb/sources/transcripts/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md - kb/sources/transcripts/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md - kb/sources/transcripts/Source - MCP Read Server Implementation Session 2026-09-02.md - kb/sources/transcripts/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md - kb/sources/transcripts/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md - kb/sources/transcripts/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md - kb/sources/transcripts/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md - tools/CONTRACT.md - tools/chemenu/lint_core.py - tools/chemenu/tests/conftest.py - tools/chemenu/tests/test_lint.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_provenance.py - tools/chemenu/tests/test_touch.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_xref.py - types/source.md - types/source.schema.yaml - types/type-spec.md - work/reclassify-source-types/README.md - work/reclassify-source-types/plan.md
63 lines
5.0 KiB
Markdown
63 lines
5.0 KiB
Markdown
---
|
|
type: types/source.md
|
|
source_type: transcript
|
|
author: GitHub Copilot (Claude Sonnet 5)
|
|
raw_files: [raw/notes/Conversation Transcript - AGENTS.md Skill Restructuring Session 2026-08-04.md]
|
|
source_language: en
|
|
date: 2026-08-04
|
|
tags: [skills, agents-md, wikitool, fact-check, restructuring]
|
|
entities: [AGENTS.md, wikitool, Chemenu, GitHub Copilot, Claude Code, Codex CLI, Mistral Vibe]
|
|
concepts: [Cross-platform Agent Skills, Token Economics, Context Isolation]
|
|
summary: Geprüfte und umgesetzte Aufteilung der 5 Workflows aus AGENTS.md in 5 einzelne Skills unter .agents/skills/; korrigiert falsche und unbelegte Aussagen aus einem früheren, ungeprüften Ingest derselben Anweisungen
|
|
---
|
|
# Source: Conversation - AGENTS.md Skill Restructuring Session 2026-08-04
|
|
|
|
**Autor:** Torben
|
|
**Datum:** 2026-08-04
|
|
**Quelle:** raw/notes/Conversation Transcript - AGENTS.md Skill Restructuring Session 2026-08-04.md
|
|
**Typ:** notes
|
|
|
|
## Zusammenfassung
|
|
|
|
Diese Sitzung analysierte, ob die fünf Workflows von `AGENTS.md` in diskrete, unabhängig entdeckbare Agent-Skills umstrukturiert werden sollten, dann wurden Faktenprüfung und Implementierung dieser Umstrukturierung durchgeführt. Die Forschung stellte fest, dass VS Code Copilot's nativer Skill-Mechanismus (`.github/skills/`, `.agents/skills/`, `.claude/skills/` mit 3-stufiger progressiver Offenlegung) der eigentliche Enabler der Idee ist, die der Benutzer beschrieb - nicht Farzas Gist, das eine einzelne Skill-Datei mit Befehlsargument-Hinweis ist, nicht mehrere unabhängig entdeckbare Skills.
|
|
|
|
Der Benutzer fügte dann einen "Web-Suchergebnis, synthetisiert" Anweisungssatz ein, der eine konkrete plattformübergreifende Umstrukturierung über GitHub Copilot, Claude Code, Codex CLI und Mistral Vibe vorschlug. Jede konkrete technische Aussage in diesem Dokument wurde unabhängig gegen primäre Quellen überprüft (offizielle Claude Code/Codex/Mistral Vibe Dokumentation, `agentskills.io` und die zitierten GitHub Repositories), bevor sie für die Planung verwendet wurde, gemäß dieser Wiki's eigener "keine sichere Antwort ohne Quelle" Regel. Zwei Aussagen wurden als falsch oder nicht überprüfbar befunden und korrigiert: Codex CLI's echter Skill-Standort ist `.agents/skills/` (nativ, kein Symlink), nicht `~/.codex/skills/`; und die "5-8x"/"61% Reduktion, 100% Lösungsquote auf 8.260-Datei-Corpus" Token-Ökonomie-Statistiken haben keine auffindbare Quelle und wurden explizit aus dem Plan ausgeschlossen.
|
|
|
|
Die Umstrukturierung wurde dann implementiert: 5 Skills (`wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-manage`, `wiki-status`) unter `.agents/skills/`, gespiegelt zu `.claude/skills/` über neue `tools/wikitool skills sync`/`verify` Befehle, und root `AGENTS.md` von 745 auf ~573 Zeilen reduziert. Diese Quelle wird auch eingereicht, um spezifische falsche/nicht überprüfbare Aussagen zu ersetzen, die bereits aus einer früheren, nicht überprüfbaren Aufnahme desselben eingefügten Anweisungssatzes in der Wiki eingereicht wurden.
|
|
|
|
## Kernaussagen
|
|
|
|
- VS Code's nativer `SKILL.md` Progressive-Disclosure-Mechanismus (nicht Farzas Single-Skill-Design) ist das, was eine echte Multi-Skill-Aufteilung lohnenswert macht - nur der Körper des relevanten Skill wird geladen.
|
|
- Codex CLI liest nativ `.agents/skills/` (gescannt von CWD bis zum Repo-Root, plus `$HOME/.agents/skills/`) - kein Symlink erforderlich, was die frühere Ingest-Aussage korrigiert.
|
|
- Mistral Vibe liest nativ `.vibe/skills/` und `.agents/skills/` (Projekt, trusted-folder-gated) sowie die `~/.vibe/skills/`/`~/.agents/skills/` Benutzerbereich-Äquivalente - direkt bestätigt aus `mistralai/mistral-vibe`'s Quellcode und Changelog.
|
|
- Claude Code liest nur `.claude/skills/` (Projekt) oder `~/.claude/skills/` (persönlich/Plugin) - es liest `.agents/skills/` nicht nativ, daher ist ein erzeugter Spiegel erforderlich.
|
|
- Die "5-8x Token-Kosten" und "61%/100% Lösungsquote auf 8.260 Dateien" Statistiken aus dem eingefügten Anweisungssatz haben keine auffindbare Quelle und sollten nirgends in dieser Wiki als Fakt behandelt werden.
|
|
- `kfchou/wiki-skills`, `vanillaflava/wiki-skills-vanillaflava` und `yugasun/llm-wiki-skills` sind alle echte Repositories, die dieses allgemeine Muster implementieren, bestätigt durch direkte Repository-Inspektion.
|
|
|
|
## Aufgaben
|
|
|
|
- [x] AGENTS.md in 5 Skills unter `.agents/skills/` umstrukturieren
|
|
- [x] `tools/wikitool skills sync`/`verify` hinzufügen und zu `.claude/skills/` spiegeln
|
|
- [ ] Falsche `~/.codex/skills/` Aussage in `Codex CLI.md` korrigieren
|
|
- [ ] Nicht überprüfte Token-Ökonomie-Statistiken in `Token Economics.md` kennzeichnen
|
|
- [ ] Die empirische "entdeckt Copilot `.agents/skills/` mit Zero-Config" Prüfung in einer zukünftigen Sitzung erneut ausführen (in dieser Sitzung unklar)
|
|
|
|
## Verwandte Entities
|
|
|
|
- [[AGENTS.md]]
|
|
- [[wikitool]]
|
|
- [[Chemenu]]
|
|
- [[GitHub Copilot]]
|
|
- [[Claude Code]]
|
|
- [[Codex CLI]]
|
|
- [[Mistral Vibe]]
|
|
- [[wiki-skills]]
|
|
- [[wiki-skills-vanillaflava]]
|
|
- [[llm-wiki-skills]]
|
|
|
|
## Verwandte Concepts
|
|
|
|
- [[Cross-platform Agent Skills]]
|
|
- [[Token Economics]]
|
|
- [[Context Isolation]]
|