| name | create-a-skill |
| description | Oppretting og forbedring av skills — SKILL.md-frontmatter, triggerbeskrivelse, progressiv disclosure, references, scripts og validering. Brukes via /create-a-skill ved ny eller eksisterende skill. |
Lage skills
Prosess
-
Samle krav — spør brukeren om:
- Hvilken oppgave/domene dekker skillen?
- Hvilke bruksscenarier skal den håndtere?
- Trenger den kjørbare skript eller kun instruksjoner?
- Finnes det referansemateriale som skal inkluderes?
-
Skriv utkast — opprett:
- SKILL.md med konsise instruksjoner (maks ~100 linjer)
- Referansefiler for utfyllende innhold
- Verktøyskript hvis det trengs deterministiske operasjoner
-
Gjennomgå med brukeren — presenter utkastet og spør:
- Dekker dette bruksscenarier dine?
- Mangler noe, eller er noe uklart?
- Bør noen seksjoner være mer/mindre detaljerte?
Filstruktur
skill-navn/
├── SKILL.md # Hovedinstruksjoner (påkrevd)
├── REFERENCE.md # Utfyllende dokumentasjon (ved behov)
├── EXAMPLES.md # Brukseksempler (ved behov)
└── scripts/ # Verktøyskript (ved behov)
└── helper.js
SKILL.md-mal
---
name: skill-navn
description: Kort beskrivelse av kapabiliteten. Brukes når [spesifikke triggere].
---
# Skill-navn
## Hurtigstart
[Minimalt fungerende eksempel]
## Arbeidsflyter
[Steg-for-steg-prosesser med sjekklister for komplekse oppgaver]
## Referanser
[Lenke til separate filer: Se [REFERENCE.md](REFERENCE.md)]
Krav til description
Beskrivelsen er det eneste agenten ser når den avgjør hvilken skill som skal lastes. Den vises i systemprompten sammen med alle andre installerte skills. Agenten leser beskrivelsene og velger riktig skill basert på brukerens forespørsel.
Mål: Gi agenten akkurat nok info til å vite:
- Hvilken kapabilitet skillen gir
- Når/hvorfor den skal aktiveres (spesifikke nøkkelord, kontekster, filtyper)
Format:
- Maks 1024 tegn
- Skriv i tredjeperson
- Første setning: hva den gjør
- Andre setning: «Brukes når [spesifikke triggere]»
# ✅ God beskrivelse
Opprett og administrer Kafka-topics, consumers og producers i Nav.
Brukes når bruker jobber med Kafka, meldingskøer eller event-strømmer.
# ❌ Dårlig beskrivelse
Hjelper med meldinger.
Den dårlige beskrivelsen gir agenten ingen mulighet til å skille skillen fra andre.
Når du bør legge til skript
Legg til verktøyskript når:
- Operasjonen er deterministisk (validering, formatering)
- Samme kode ville blitt generert gjentatte ganger
- Feil krever eksplisitt håndtering
Skript sparer tokens og gir bedre pålitelighet enn generert kode.
Når du bør dele opp i filer
Del opp i separate filer når:
- SKILL.md overskrider 100 linjer
- Innholdet har distinkte domener (ulike skjemaer, ulike kontekster)
Lean-filter
Alt innhold skal bestå lean-filteret:
- Kan modellen dette fra før? Dropp generell syntax, velkjente mønstre og standardbibliotek-kunnskap.
- Lærer det å jobbe i Nav, eller styrker det agenten? Behold Nav-spesifikke mønstre, plattformkunnskap og teamkonvensjoner.
Drop hvis ja på 1 og nei på 2.
Grenser
Alltid
- Skriv innholdet på norsk hvis repoet forventer norsk
Spør først
- Om skillen overlapper med en eksisterende skill
Aldri
- Dupliser ren LLM-allmennkunnskap uten Nav- eller repo-verdi
Sjekkliste
Etter utkastet, verifiser:
