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

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.