GitHub Copilot i VS Code har flere tilpasningstyper. De ser like ut — markdown-filer i .github/ — men løser forskjellige problemer. Her er hvordan du velger riktig type.

Tilpasningstyper

Vi dekker de tre første — instruksjoner, skills og agenter — som er mest relevante å lage selv.

Instruksjoner — regler som alltid gjelder

Instruksjoner er den enkleste tilpasningen. Du skriver regler i en markdown-fil, angir et glob-mønster, og reglene gjelder automatisk for matchende filer. Du trenger ikke aktivere noe manuelt.

Bruk instruksjoner for:

• Kodestandarder ("bruk Aksel spacing tokens, aldri Tailwind p-/m-")
• Språkkonvensjoner (Go-idiomer, Kotlin-mønstre)
• Sikkerhetsregler (OWASP-sjekker for Kotlin og Go)
• Review-retningslinjer (hva Copilot skal flagge i PR-er)

---
applyTo: "**/*.{kt,go}"
---
# OWASP Top 10 — kodenivå
Bruk parameteriserte spørringer. Logg aldri PII...

Instruksjoner er passive — de påvirker AI-ens svar uten at du trenger å tenke på dem. VS Code-dokumentasjonen anbefaler å starte her: «Start with a single .github/copilot-instructions.md file for project-wide coding standards. Add .instructions.md files when you need different rules for different file types.»

Viktig: Instruksjoner gjelder ikke for inline-forslag mens du skriver — kun for chat, agenter og code review.

Skills — kunnskap og workflows on-demand

Skills er mapper med en SKILL.md-fil som inneholder instruksjoner, og valgfritt skript, maler og referansemateriale. De lastes bare når oppgaven matcher — så de bruker ikke opp kontekstvinduet.

Skills er en åpen standard som fungerer i VS Code, Copilot CLI og kodingsagenten — så en skill du lager i repoet virker uansett hvor du jobber.

Bruk skills for:

• Scaffolding (/ktor-scaffold, /spring-boot-scaffold)
• Diagnostikk (/nav-troubleshoot, /observability-debugging)
• Domenekunnskap (/api-design, /flyway-migration)
• Sikkerhetsprosedyrer (/security-review)

my-skill/
├── SKILL.md          # Påkrevd: metadata + instruksjoner
├── scripts/          # Valgfritt: kjørbar kode
├── references/       # Valgfritt: referansemateriale
└── assets/           # Valgfritt: maler og ressurser

Gode råd for skills

Agent Skills-spesifikasjonen gir konkrete råd:

• Skriv det agenten ikke vet. Fokuser på prosjektspesifikke konvensjoner, API-detaljer og kjente fallgruver. Du trenger ikke forklare hva en database er.
• Hold det under 500 linjer. Flytt detaljert referansemateriale til references/-mappen og fortell agenten når den skal laste det.
• Inkluder en gotchas-seksjon. Feil agenten gjør uten å bli fortalt — dette er ofte det mest verdifulle innholdet.
• Test med ekte oppgaver. Kjør skillen mot reelle oppgaver, les agenttracene, og oppdater basert på hva som fungerer.

Agenter — spesialister med egne verktøy

Agenter er den mest avanserte tilpasningen. De definerer en persona med egne verktøy, modellvalg og handoffs til andre agenter. VS Code-dokumentasjonen beskriver dem slik: «Custom agents give the AI a specific persona and constrained set of tools for a particular role.»

Bruk agenter når du trenger:

• Verktøybegrensning — en planleggingsagent som kun kan lese, ikke redigere
• Modellvalg — Opus for arkitektur, Codex for implementering
• MCP-verktøy — tilgang til Figma, GitHub API eller databaser
• Handoffs — sekvensielle workflows (Plan → Implementer → Review)

---
name: aksel-agent
model: Claude Sonnet 4.6
tools:
  - com.figma/figma-mcp/get_design_context
  - com.figma/figma-mcp/get_variable_defs
  - search
  - edit
---

Den viktigste forskjellen: agenter styrer hvilke verktøy som er tilgjengelige. En agent uten verktøybegrensning er i praksis bare en skill med ekstra overhead.

Beslutningstre

Skal reglene gjelde automatisk for en filtype?
  → Ja → Instruksjon (.instructions.md)

Trenger du verktøybegrensning, modellvalg eller MCP?
  → Ja → Agent (.agent.md)

Er det domenekunnskap, workflow eller prosedyre?
  → Ja → Skill (SKILL.md)

Er det en enkel engangsoppgave med forhåndsdefinert kontekst?
  → Ja → Prompt (.prompt.md)

Vanlige feil

Hva vi har gjort i navikt

• Lagt til code-review.instructions.md — review-regler for sikkerhet, NAIS-konfig, GitHub Actions og testdekning. Gjelder automatisk.
• Identifisert duplikater — flere agenter og skills har overlappende innhold. Se issue #252 for oppryddingsplan.
• Beholdt agenter med reell verktøykontroll — @aksel-agent (Figma MCP), @nav-pilot (Opus + orkestrator), @security-champion (Opus + rådgiver).

Kom i gang

VS Code har innebygde kommandoer for å generere tilpasninger:

• /create-instruction — lag en instruksjon for kodestandarder
• /create-skill — lag en skill for workflows
• /create-agent — lag en agent med verktøykontroll
• /create-prompt — lag en prompt for enkeltoppgaver

Start med instruksjoner. Legg til skills for workflows teamet gjentar. Bruk agenter bare når du trenger verktøykontroll eller modellvalg.

Kilder

• VS Code: Customization concepts — offisiell oversikt over alle tilpasningstyper
• VS Code: Custom instructions — instruksjoner og glob-mønstre
• VS Code: Agent skills — skills-format og bruk
• VS Code: Custom agents — agenter, verktøy og handoffs
• Agent Skills specification — åpen standard for skills (Anthropic)
• Best practices for skill creators — hvordan skrive gode skills
• GitHub Blog: How to write a great agents.md — analyse av 2 500+ repoer