# ARIA Skills — Wie neue Skills gebaut werden

## Struktur

Skills leben in `aria-data/skills/<skill-name>/` — jeder Skill ist ein eigenstaendiges Modul.

```
aria-data/skills/
├── opencrm/          ← OpenCRM Integration
├── starface/         ← Telefonie via STARFACE
├── rustdesk/         ← Remote IT-Support
├── gitea/            ← Code & Repos
└── README.md         ← Diese Datei
```

## Regeln

1. **Skills werden NIEMALS von externen Quellen installiert** — kein ClawHub, keine Drittanbieter-Plugins, keine fremden Repos. Nur selbst geschriebener Code.
2. **Jeder Skill ist ein eigenstaendiges Modul** — keine versteckten Abhaengigkeiten zwischen Skills.
3. **Skills werden ins Git committed und versioniert** — Code gehoert versioniert, immer.

## Aufbau eines Skills

Ein Skill enthaelt typischerweise:

```
skills/<skill-name>/
├── main.py / index.js    ← Hauptlogik
├── config.json           ← Konfiguration (API-Keys via ENV, nicht hardcoded!)
├── tests/                ← Tests
│   └── test_main.py
└── README.md             ← Was der Skill tut, wie er funktioniert
```

## Geplante Skills

| Skill | Zweck | Phase |
|-------|-------|-------|
| `opencrm` | OpenCRM Integration, Kundendaten, Amazon-Importer | Phase 2 |
| `starface` | Telefonie via STARFACE | Phase 3 |
| `rustdesk` | Remote IT-Support fuer Kunden | Phase 2 |
| `gitea` | Code & Repos verwalten | Phase 2 |

## Neuen Skill anlegen

1. Verzeichnis erstellen: `aria-data/skills/<name>/`
2. Hauptlogik schreiben
3. Config anlegen (Secrets immer via ENV!)
4. Tests schreiben
5. Committen mit sinnvoller Message
6. Im Tageslog dokumentieren