Skills i AI-agenter — Dataviter AS

01

Grunnkonseptet

Hva er egentlig en skill?

En stor språkmodell er utrolig generell. Den kan skrive, kode, analysere, oversette — men den vet ingenting om din bedrift, ditt kodestil eller dine designregler. Den kjenner ikke databaseskjemaet ditt, merkevareprofilen din, eller hvordan dere skriver kundebrev.

En skill løser dette. Det er en tekstfil — gjerne skrevet i Markdown — som inneholder all den ekspertkunnskapen agenten trenger for å gjøre en spesifikk type jobb riktig. Agenten leser filen før den starter, og handler deretter.

«En skill er som en fagbok skrevet av en ekspert, som agenten leser på sekunder og deretter anvender perfekt — hver gang.»

📖

SKILL.md

Ekspertise i en fil

En skill inneholder typisk:

🎯

Formål og kontekstHva skal agenten gjøre, og for hvem? Hva er målet med oppgaven?

📋

Regler og kravHva er obligatorisk? Hva skal aldri gjøres? Standarder og konvensjoner.

✅

Eksempler og mønstreKonkrete eksempler på god og dårlig output. Maler og strukturer å følge.

⚠️

Fallgruver å unngåVanlige feil, misforståelser og hjørnetilfeller agenten må håndtere riktig.

02

Mekanismen

Hvordan fungerer det i praksis?

Agenten oppdager selv hvilke skills som er relevante for en oppgave — ved å se på oppgavebeskrivelsen og tilgjengelige skill-filer. Den leser skill-filen, internaliserer innholdet, og handler i tråd med det. Alt skjer automatisk.

1

Agenten mottar en oppgave «Lag en kvartalspresentasjon om salgstallene for Q3» — en åpen instruksjon uten detaljerte regler.

2

Agenten sjekker tilgjengelige skills Den finner design.skill, pptx.skill og dataviter-brand.skill — alle relevante for presentasjoner.

3

Agenten leser skill-filene Fargepalett, typografi, layout-regler, tone of voice, strukturkrav — alt er der. Tar millisekunder.

4

Agenten løser oppgaven med ekspertise Produserer en presentasjon med riktig merkevare, riktig format, riktig tone — uten at du trengte å spesifisere noe av det.

💡

Skills vs. systemprompter

En systemprompt gir agenten generelle instruksjoner som alltid er til stede. En skill er mer modulær — agenten velger å lese den når den er relevant. Det betyr at én agent kan mestre mange domener ved å ha tilgang til mange skills, uten at alt behøver å være i kontekstvinduet hele tiden.

03

Eksempel 1 av 4

Design-skill — konsistent merkevare

Uten en design-skill vil en agent lage visuelt innhold med tilfeldige farger, fonter og layouts. Med en design-skill produserer den materiell som ser ut som det kom fra din designavdeling — hver gang, uten unntak.

Uten design-skill

Tilfeldig fargevalg basert på "hva ser bra ut"

Font varierer fra gang til gang

Layout følger ingen fast mal

Ingen konsistent tone of voice

Logo plassert feil eller ikke med

Med design-skill

Alltid Dataviter Blue #0076BF og Green #76BC17

League Spartan for headings, DM Sans for brødtekst

Cover-mal, innholdsmal og avslutningsmal alltid brukt riktig

Tone: profesjonell, tilgjengelig, norsk bokmål

Logo plassert top-left med riktig clearance

Slik ser et utdrag av en design-skill ut:

design.skill.md
# Dataviter AS — Design Skill## FargerPrimær blå:  #0076BF  — bruk på headings, knapper, kort-border
Aksent grønn: #76BC17  — bruk sparsomt, maks 1 element per seksjon
ALDRI bruk rød for annet enn faktiske feil/varsler.

## Typografi
Headings:  League Spartan, weight 700–800, letter-spacing -0.02em
Brødtekst: DM Sans, weight 400, line-height 1.7

## Layout-regler
- Cover-slides: Mørk blå bakgrunn (#1766AA), hvit tittel, grønn aksent
- Innholdsslides: Cream bakgrunn (#FFFBFA), blå seksjontitler
- Bunntekst på alle slides: "FRA DATA TIL VERDI · dataviter.no"

# Sjekkliste før du leverer:# [ ] Kun farger fra paletten over# [ ] Grønn brukt sparsomt (1 element per slide)# [ ] Logo øverst til venstre med riktig luft

04

Eksempel 2 av 4

SQL-skill — skriv spørringer riktig

En SQL-skill er noe av det mest verdifulle du kan gi en data-agent. Den inneholder databaseskjemaet ditt, navnekonvensjoner, hvilke tabeller som finnes, hvilke kolonner som betyr hva — og viktige regler som "aldri gjør full table scan på orders uten datofilter".

Resultatet er at agenten kan svare på forretningsspørsmål direkte i databasen din, uten feil og uten å trenge en dataingeniør i løypen for hvert spørsmål.

sql-analytics.skill.md
# SQL Analytics Skill — Bedrift AS## Databaseskjema (relevante tabeller)orders         — id, customer_id, created_at, total_amount, status
customers      — id, name, segment, country, created_at
order_items    — id, order_id, product_id, qty, unit_price
products       — id, name, category, cost_price

## Navnekonvensjoner
- Datokolonner heter alltid _at (f.eks. created_at, shipped_at)
- Status-verdier i orders: 'pending', 'confirmed', 'shipped', 'cancelled'
- Segment-verdier: 'enterprise', 'smb', 'consumer'## Regler
1. ALLTID filtrer på created_at når du spør mot orders (stor tabell)
2. Bruk LEFT JOIN mot customers — ikke alle ordre har kunde
3. Beregn margin som: (unit_price - cost_price) / unit_price
4. Avrund pengebeløp til 2 desimaler

## Eksempel — månedlig omsetning:
SELECT DATE_TRUNC('month', created_at) AS mnd,
       SUM(total_amount)             AS omsetning
FROM   orders
WHERE  status != 'cancelled'
  AND  created_at >= NOW() - INTERVAL '12 months'
GROUP  BY 1 ORDER BY 1;
    

🔍

Hva dette muliggjør

En analytiker kan nå spørre agenten: «Hvilke kunder i enterprise-segmentet har ikke handlet på over 60 dager?» — og få en ferdig, korrekt SQL-spørring tilbake i løpet av sekunder, med riktige tabeller, riktige joins og riktige filtre. Ingen feil, ingen misforståelser av skjemaet.

05

Eksempel 3 og 4 av 4

Rapport-skill og kode-skill

Skills finnes for nesten enhver type oppgave. Her er to eksempler til — én for strukturert rapportskriving, og én for konsistent kodestil.

📄

Rapport-skill

Kunderapporter og analyser

Definerer struktur, tone og innholdskrav for alle rapporter bedriften sender til kunder. Agenten vet nøyaktig hvilke seksjoner som skal med, hvilke tall som alltid skal være med, og hvordan avvik skal presenteres.

## Rapportstruktur 1. Sammendrag (maks 150 ord) 2. Nøkkeltall (3–5 KPI-er med trend) 3. Analyse (funn og forklaringer) 4. Anbefalinger (konkrete, nummererte) ## Tone: profesjonell, direkte. ## Unngå: passiv form, jargon, ## vage formuleringer som "kan tyde på"

💻

Kode-skill

Python / TypeScript standarder

Inneholder kodestandarder, navnekonvensjoner, hvilke biblioteker som er godkjente, og mønstre teamet har valgt. Agenten skriver kode som ser ut som den kom fra det beste medlemmet av teamet ditt.

## Python-standarder - Type hints på alle funksjoner - pydantic for datavalidering - Unngå: bare except: — alltid spesifikk - Funksjoner: snake_case, klasser: PascalCase - Maks 40 linjer per funksjon ## Tester: alltid pytest, ## mocking med unittest.mock

Skills finnes for svært mange domener. Her er et utvalg av hva som er vanlig:

design.skill — Merkevare og visuell identitet

sql.skill — Databaseskjema og spørreregler

pptx.skill — PowerPoint-presentasjoner

pdf.skill — PDF-generering og formatering

rapport.skill — Rapportstruktur og tone

kode.skill — Kodestil og teamkonvensjoner

e-post.skill — Kundekommunikasjon

juridisk.skill — Kontraktsspråk og krav

onboarding.skill — Nye medarbeideres rutiner

data-kvalitet.skill — Valideringsregler for data

din-bedrift.skill — Alt som er spesifikt for deg

06

Bygg din egen

Hvordan lager du en skill?

En skill er i bunn og grunn en velskrevet tekstfil. Det finnes ingen teknisk magi her — styrken ligger i kvaliteten på innholdet, ikke i formatet. Her er tilnærmingen som fungerer.

🎯

1. Definer én oppgave

En god skill har ett klart formål. Ikke prøv å pakke alt inn i én fil — lag heller flere spesifikke skills. Design er én skill, rapportskriving er en annen.

🧠

2. Spør eksperten

Den beste kilden til en skill er personen i bedriften som er ekspert på domenet. Hva ville de fortalt en ny kollega? Det er skill-en.

🔁

3. Test og iterer

Kjør agenten mot skill-en og se hva som skjer. Mangler det regler? Er noe uklart? En skill er et levende dokument — oppdater den når du oppdager hull.

Her er en enkel mal du kan bruke som utgangspunkt for en ny skill:

skill-mal.md
# [Navn på skill] — [Bedrift/system]## FormålBeskriv i 2–3 setninger hva denne skill-en hjelper agenten med å gjøre.Eksempel: "Hjelper agenten skrive konsistente kunderapporter i Bedrift AS-stil."## KontekstRelevant bakgrunnsinformasjon: hvem er målgruppen, hva er systemet,hva er de viktigste hensyn å ta?## Regler og krav
- ALLTID: [Ting som alltid skal gjøres]
- ALDRI:  [Ting som aldri skal gjøres]
- [Andre viktige konvensjoner]

## Eksempel på god outputVis ett konkret eksempel på hva riktig output ser ut som.Dette er ofte det mest nyttige innholdet i hele skill-en.## Vanlige feil å unngåListe over kjente fallgruver og misforståelser.## Sjekkliste# [ ] Sjekk 1# [ ] Sjekk 2# [ ] Sjekk 3

✍️

Tips: La Claude hjelpe deg skrive skill-en

Du trenger ikke skrive skill-en fra bunnen av selv. Beskriv domenet ditt til Claude, vis noen eksempler på god og dårlig output, og be den lage et utkast til en skill. Deretter gjennomgår du og justerer det som ikke stemmer. Mange av de beste skills er laget på under 20 minutter på denne måten.

07

Det store bildet

Skills, MCP og agenter — tre lag i ett system

Skills er kraftigst når de kombineres med de to andre nøkkelkonseptene i moderne AI-arkitektur. Alene er en skill nyttig. Kombinert med MCP og en agent er det transformativt.

📖

Skill

Gir agenten ekspertise. Den vet hvordan jobben skal gjøres — hvilke regler som gjelder, hvilke mønstre som er riktige, hva som aldri skal gjøres.

🔌

MCP

Gir agenten tilgang. Den kan koble seg til databasen din, CRM-et, Slack, filsystemet — og faktisk gjøre noe, ikke bare snakke om det.

🤖

Agent

Gir agenten selvstendighet. Den kan planlegge, dele opp oppgaver, bruke verktøy i riktig rekkefølge og fullføre komplekse arbeidsflyter uten manuell styring.

💡

Eksempel: fullstendig arbeidsflyt

En salgssjef sier: «Lag en ukentlig kunderapport for enterprise-segmentet.»

Agenten bruker SQL-skill for å vite hvilke spørringer å kjøre → bruker MCP for å hente data fra databasen → bruker rapport-skill for å strukturere innholdet riktig → bruker design-skill for å formatere det i riktig merkevare → leverer en ferdig PDF til salgssjefens e-post. Alt uten et eneste manuelt steg.

Skills —
gi agenten din
innebygd ekspertise