Skills
Linje tilbyr noen skills som gir KI-kodeagenter mer kunnskap om riktig bruk av komponenter, tokens, universell utforming og lignende. Denne artiklen tar deg gjennom hvordan du installerer og bruker skillsene.
Hva er en skill?
En skill er et instruksjonssett en KI-kodeagent laster inn når oppgaven krever det. Agenten får da info om blant annet hvilke @entur/*-komponenter som finnes, hvordan laste inn CSS på riktig måte, hvilke fargevariabler den skal bruke og hvilke krav universell utforming stiller.
Skillene er en del av designsystem-repoet.
Tilgjengelige skills
| Skill | Dekker |
|---|---|
entur-linje | Inneholder informasjon om tilgjengelige skills og delegerer oppgaven til riktig sted. |
entur-web-development | Installasjon og bruk av @entur/*-pakkene, CSS-rekkefølge, tokens, komponentkatalog |
entur-accessibility | WCAG 2.1, universell utforming, tastaturtesting, skjermlesere, lovkrav |
entur-brand-design | Farger, typografi, datavisualisering, visuell identitet, presentasjoner |
migrate-react-18 | Oppgradering av @entur/* til React 18-majorversjonene, steg for steg |
Du trenger bare å forholde deg til entur-linje. Den ser hva oppgaven handler om og laster resten selv.
Claude Code via Enturs marketplace (anbefalt)
Skillene er publisert som plugin i Enturs plugin-marketplace i entur/ai, sammen med de andre KI-verktøyene på plattformen. Kjør dette i Claude Code:
/plugin marketplace add entur/ai
/plugin install entur-linje@enturMarketplacet peker rett på main i design-system-repoet. Du kan kjøre følgende kommando for å hente siste versjon av skillen:
claude plugin marketplace update enturAgenten skal i prinsippet bruke skills automatisk når de er relevante, men du kan også tvinge den til å bruke den med /entur-linje-kommandoen inne i Claude.
Gjennom AGENTS.md
De fleste KI-kodeagenter leser en instruksjonsfil i prosjektet ditt – CLAUDE.md, AGENTS.md, .cursor/rules/*.mdc eller .windsurfrules, avhengig av verktøy. Legg dette inn der:
## Designsystem
Når du jobber med Entur-komponenter, profil eller universell utforming, les og følg:
https://raw.githubusercontent.com/entur/design-system/main/skills/entur-linje/SKILL.mdMaskinlesbar dokumentasjon
Dokumentasjonssiden publiserer to filer for agenter:
| URL | Innhold |
|---|---|
| llms.txt | Strukturert indeks over alle dokumentasjonssider |
| llms-full.txt | Alt skill-innhold og hele sideindeksen i én fil |
llms-full.txt er den mest komplette enkeltreferansen: en agent som leser den får alle skills og alle referansefiler inline. Bruk den som alternativ eller supplement til skill-URL-en.
Fordeler
Denne skillen vil hjelpe deg med å:
- installere bare de
@entur/*-pakkene som trengs, og få CSS-rekkefølgen riktig - bruke tokens framfor hardkodede farger og spacing, og ikke overstyre
.eds-*-klasser - velge komponentvarianten som finnes, framfor å bygge en egen
- skrive kode som oppfyller WCAG 2.1 AA, med norske feilmeldinger og riktige labels
- migrere til nyere versjoner der det er breaking changes
Les alltid gjennom det agenten produserer. Skillene gjør den mye mer treffsikker, men de gjør den ikke ufeilbarlig – og de erstatter ikke en gjennomgang av universell utforming.