skybert-plugin

Fhi.AgentSkills

En samling domenekunnskap i markdown-format som AI-agenter kan bruke for å gi bedre assistanse til utviklere ved Folkehelseinstituttet.

Hva er Agent Skills?

Agent Skills er strukturert domenekunnskap pakket som markdown-filer som AI-verktøy kan lese og bruke som kontekst. I stedet for at hver utvikler må forklare komplekse systemer til AI-assistenten sin gang på gang, kan vi dele denne kunnskapen på tvers av organisasjonen.

Fordeler:

• Konsistent og kvalitetssikret informasjon
• Slipper å gjenta forklaringer
• AI-en får dyp forståelse av FHI-spesifikke systemer
• Enkel oppdatering når ting endres

Tilgjengelige Skills

Skill	Beskrivelse
skybert	Skybert-plattformen (FHI sin Kubernetes-plattform). GitOps, SkybertApp CRD, Azure Workload Identity, Flux, onboarding og feilsøking.
designsystem	FHI Designsystem (@folkehelseinstituttet/designsystem). Komponenter, design tokens, ikoner og rammeverk-integrasjon (React, Angular, Blazor).

Interne vedlikeholds-skills

Disse skillene brukes til å holde domenekunnskap-skillene i dette repoet oppdatert.

Skill	Beskrivelse
oppdater-skybert	Synkroniserer skybert-skillen med siste versjon av docs.sky.fhi.no.
oppdater-designsystem	Synkroniserer designsystem-skillen med siste publiserte npm-versjon.

Merk: Disse ligger kanonisk under .claude/skills/ og skal ikke symlinkes til andre prosjekter.

Plugin

skybert er også tilgjengelig som plugin, som alternativ til symlink-oppsettet under.

Claude Code – distribueres direkte fra skybert/ via en marketplace i repoet:

/plugin marketplace add FHIDev/Fhi.AgentSkills
/plugin install skybert-plugin@fhi-agent-skills

Se docs/claude-plugin-skybert.md for detaljer.

Codex – en egen Codex-plugin under plugins/codex/skybert-plugin/ lenker til skybert/ via en symlink (ingen kopi), med marketplace i .agents/plugins/marketplace.json. Se docs/codex-plugin-skybert.md for detaljer og forbehold.

Installasjon

1. Klon repoet

git clone https://github.com/FHIDev/Fhi.AgentSkills.git

Velg en plassering du husker, f.eks. ~/repos/Fhi.AgentSkills eller C:\repos\Fhi.AgentSkills.

2. Sett opp for ditt AI-verktøy

Symlink skillene du ønsker å bruke. Tilgjengelige skills for bruk i prosjekter er skybert og designsystem.

Claude Code

Claude Code støtter skills på to nivåer:

Globalt (alle prosjekter):

# macOS/Linux
mkdir -p ~/.claude/skills
# Generisk mønster:
# ln -s ~/repos/Fhi.AgentSkills/<skill-navn> ~/.claude/skills/<skill-navn>

ln -s ~/repos/Fhi.AgentSkills/skybert ~/.claude/skills/skybert
ln -s ~/repos/Fhi.AgentSkills/designsystem ~/.claude/skills/designsystem

# Windows (PowerShell som admin)
mkdir -Force "$env:USERPROFILE\.claude\skills"
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.claude\skills\skybert" -Target "C:\repos\Fhi.AgentSkills\skybert"
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.claude\skills\designsystem" -Target "C:\repos\Fhi.AgentSkills\designsystem"

Per prosjekt:

# macOS/Linux
mkdir -p .claude/skills
# Generisk mønster:
# ln -s ~/repos/Fhi.AgentSkills/<skill-navn> .claude/skills/<skill-navn>

ln -s ~/repos/Fhi.AgentSkills/skybert .claude/skills/skybert
ln -s ~/repos/Fhi.AgentSkills/designsystem .claude/skills/designsystem

# Windows (PowerShell som admin)
mkdir -Force ".claude\skills"
New-Item -ItemType SymbolicLink -Path ".claude\skills\skybert" -Target "C:\repos\Fhi.AgentSkills\skybert"
New-Item -ItemType SymbolicLink -Path ".claude\skills\designsystem" -Target "C:\repos\Fhi.AgentSkills\designsystem"

OpenAI Codex

Codex bruker AGENTS.md og kan referere til eksterne filer.

Global plassering:

# macOS/Linux
mkdir -p ~/.agents/skills
# Generisk mønster:
# ln -s ~/repos/Fhi.AgentSkills/<skill-navn> ~/.agents/skills/<skill-navn>

ln -s ~/repos/Fhi.AgentSkills/skybert ~/.agents/skills/skybert
ln -s ~/repos/Fhi.AgentSkills/designsystem ~/.agents/skills/designsystem

# Windows (PowerShell som admin)
mkdir -Force "$env:USERPROFILE\.agents\skills"
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.agents\skills\skybert" -Target "C:\repos\Fhi.AgentSkills\skybert"
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.agents\skills\designsystem" -Target "C:\repos\Fhi.AgentSkills\designsystem"

I AGENTS.md:

## Domenekunnskap

Se [skybert skill](~/.agents/skills/skybert/SKILL.md) for Skybert-plattformen.
Se [designsystem skill](~/.agents/skills/designsystem/SKILL.md) for FHI Designsystem.

Merk: ~ er kun et eksempel (hjemmekatalog). Tilpass stien til din faktiske plassering og operativsystem.

Cursor