BACH SKILLS TOOLS
=================

Tools zur Verwaltung, Überwachung und Validierung von BACH-Skills.

SCHNELLSTART
------------
  bach --maintain skills                    # Skill-Gesundheitscheck
  bach skill list                          # Skills auflisten
  bach skill export NAME                   # Skill exportieren

WAS SIND SKILLS?
----------------
Skills sind wiederverwendbare Fähigkeiten-Module in BACH:
- _agents/: Boss-Agenten (ATI, Steuer-Agent, etc.)
- _experts/: Experten-Skills (data-analysis, etc.)
- _services/: Service-Skills (communicate, recurring, etc.)

SKILL HEALTH MONITOR
--------------------
Überwacht und validiert alle Skills.

Befehle:
  python tools/maintenance/skill_health_monitor.py check
  python tools/maintenance/skill_health_monitor.py check --skills
  python tools/maintenance/skill_health_monitor.py check --agents
  python tools/maintenance/skill_health_monitor.py report

Was wird geprüft:
- SKILL.md Vollständigkeit (name, version, description)
- Agent-Manifest (manifest.json)
- Verzeichnisstruktur
- Verwaiste oder fehlerhafte Skills

Integration in --startup:
Der Skill Health Monitor läuft automatisch bei Session-Start
und meldet Probleme in der Startup-Ausgabe.

SKILL EXPORT/IMPORT
-------------------
Skills können exportiert und auf anderen Systemen installiert werden.

Export:
  bach skill export SKILLNAME
  -> Erstellt SKILLNAME.zip mit allen Dateien + manifest.json

Import:
  bach skill install PFAD/skill.zip
  -> Entpackt und integriert in skills/

ATI EXPORT (Agent-spezifisch):
  bach ati export
  -> Exportiert ATI-Agent mit allen Abhängigkeiten

SKILL-VERZEICHNISSTRUKTUR
-------------------------
skills/
├── SKILL.md               # Haupt-SKILL.md (BACH selbst)
├── AGENT_KONVENTION.md    # Agent-Regeln
├── SKILL_ANALYSE.md       # Abdeckungsanalyse
│
├── _agents/               # Boss-Agenten
│   ├── ati/              # Software-Entwickler-Agent
│   ├── steuer-agent.txt  # Steuer-Agent
│   └── ...
│
├── _experts/              # Experten-Module
│   └── data-analysis/    # Datenanalyse-Expert
│
└── _services/             # Hintergrunddienste
    ├── communicate.md    # Partner-Kommunikation
    └── recurring/        # Periodische Tasks

SKILL.MD FORMAT
---------------
Jede SKILL.md muss YAML-Frontmatter haben:

---
name: skill-name
version: 1.0.0
description: Kurze Beschreibung
last_updated: 2026-01-23
---

# Skill-Name

Inhalt und Dokumentation...

VALIDIERUNG
-----------
Pflichtfelder: name, version, description
Empfohlen: last_updated, author, dependencies

Agenten brauchen zusätzlich:
- manifest.json (PFLICHT)
- README.md (empfohlen)
- CHANGELOG.md (empfohlen)

DATENBANK-INTEGRATION
---------------------
Skills werden in bach.db registriert:

  SELECT * FROM skills;                    # Alle Skills
  SELECT * FROM agents;                    # Alle Agenten
  SELECT * FROM agent_synergies;           # Agent-Beziehungen

CLI-BEFEHLE
-----------
  bach --maintain skills      # Gesundheitscheck (in --startup)
  bach skill list             # Skills aus DB auflisten
  bach skill export NAME      # Skill exportieren
  bach skill install PFAD     # Skill installieren

TIPPS
-----
- Skill Health Monitor läuft bei jedem --startup
- Probleme werden als Warnings/Errors gemeldet
- Bei neuen Skills: SKILL.md mit korrektem Frontmatter erstellen
- Agenten immer mit manifest.json erstellen

SIEHE AUCH
----------
  bach --help agents           # Agenten-Dokumentation
  bach --help ati              # ATI-Agent Details
  bach --help maintain         # Wartungs-Tools
  skills/AGENT_KONVENTION.md   # Agent-Regeln

---
Version: 1.0.0
Erstellt: 2026-01-23
Teil von: BACH Tool-Dokumentation
