# Radix-Skills

Delt AI-skill-bibliotek for Radix. Bruges af alle medarbejderes AI-agenter
(Hermes, Codex m.fl.) til dansk regnskab/ERP, data-afstemning og devops-workflows.

> **Hvad er en "skill"?** En self-contained YAML-frontmatter + markdown-fil
> (`SKILL.md`) der beskriver et domæne-specifikt workflow, som en AI-agent kan
> loade på forespørgsel. Tænk på det som en delt playbook for en bestemt
> type opgave.

## Struktur

```text
Radix-Skills/
├── README.md                  # denne fil
├── index.json                 # maskinlæseligt index over alle skills
└── skills/
    ├── accounting/            # dansk regnskab, bogføring, ERP
    │   ├── radix-accounting/  # top-level bogholderi-skill (sprog, formater, aktivering)
    │   ├── coop-bankimport/
    │   ├── dansk-csv-import/
    │   ├── e-conomic-integration/
    │   ├── kontoplan-mapping/
    │   ├── momsafregning/
    │   └── resultatopgoerelse/
    ├── data-science/
    │   └── erp-data-reconciliation/   # afstemning mellem ERP-systemer
    └── devops/
        ├── gitea-issue-agent/         # agent-drevet Gitea issue/PR-workflow
        └── kanban-workflows/
```

Hver skill ligger i sin egen mappe og har mindst `SKILL.md`. Større skills
kan have undermapper:

- `references/`  — uddybende dokumentation der kun loades ved behov
- `templates/`   — skabeloner (f.eks. issue-kommentarer, rapporter)
- `scripts/`     — hjælpescripts der følger med skillen

## Hvordan en agent bruger repo'et

1. Læs `index.json` for at finde relevante skills ud fra tags/description.
2. Gå ind i den relevante `skills/<kategori>/<navn>/` mappe.
3. Læs `SKILL.md` (med YAML-frontmatter) for at aktivere skillen.
4. Følg de nummererede steps i skillen.
5. Hvis skillen henviser til en reference, load den først når det er relevant
   (ikke alle på én gang).

## Bidrag

Nye skills skal:

1. Lægges under `skills/<kategori>/<skill-navn>/` med en `SKILL.md`.
2. Følge SKILL.md-formatet (YAML-frontmatter med `name`, `description`,
   `version`, `author`, `license` + markdown body).
3. Have en kort `description` der kan bruges til trigger-matching.
4. Have en `version` der følger semver.
5. Blive registreret i `index.json` (kør `python3 scripts/rebuild_index.py`).

Åbn en Gitea-PR med ændringerne — `gitea-issue-agent`-skillen kan guide dig.

## Vedligeholdelse

- `index.json` genereres automatisk af `scripts/rebuild_index.py` ud fra
  frontmatter i alle `SKILL.md` filer.
- Store ændringer (ny kategori, formatændring) kræver opdatering af denne
  `README.md`.