Dokumentasjon

macOS / Linux — Homebrew

# Ajouter le tap STH (une seule fois)
brew tap skills-transfer-hub/sth

# Approuver le tap — requis pour un tap tiers depuis Homebrew 6.0 (une seule fois)
brew trust skills-transfer-hub/sth

# Installer
brew install skills-transfer-hub/sth/sth

# Vérifier
sth version

Stegene tap og trust gjøres bare én gang — trust er sikkerhetsporten i Homebrew 6.0 for tredjeparts-tapper. Deretter oppdaterer du STH med brew upgrade sth, ikke sth update self.

Windows — winget eller Chocolatey

# winget
winget install STH.STH

# Scoop
scoop bucket add sth https://github.com/Skills-transfer-hub/scoop-sth
scoop install sth

# Chocolatey
choco install sth

Binær fra GitHub Releases

Hvis du foretrekker manuell installasjon eller er på en plattform som ikke støttes, last ned tilsvarende arkiv fra Releases-siden (hvert arkiv kommer med en SHA256SUMS-fil for å verifisere integritet), og plasser binæren i din PATH.

# macOS / Linux
tar -xzf sth-darwin-arm64.tar.gz   # ou linux-amd64, darwin-amd64
chmod +x sth
sudo mv sth /usr/local/bin/

# Windows : extraire sth-windows-amd64.zip et déplacer sth.exe dans un dossier de %PATH%

Verifiser installasjonen

sth version

Fra prosjektroten (typisk en mappe som allerede inneholder .claude/):

sth init
? Fournisseur          › github | gitlab | azure-devops | bitbucket
? Dépôt / org-projet   › acme-corp/skills
? Branche / ref        › main
? Catalogue            › SKILLS.md
? Dossier cible        › .claude/skills

Konfigurasjonen skrives til .sth/project.json (schema v2). Ingen hemmeligheter lagres der — STH leser Git-tokens fra miljøet ditt.

sth uten argument i en interaktiv terminal åpner den guidede menyen og foreslår neste nyttige handling (init, list, install, update, buddy…).

sth uten argument i en interaktiv terminal spiller en kort oppvåknings-animasjon — 💤 deretter 👀 — og fryser så Buddy på prosjektets faktiske tilstand. Alt i en 78 tegn bred ramme.

╭────────────────────────────────────────────────────────────────────────────╮
│                                                                            │
│      💧                                                                    │
│    ╭─────╮   STH dev                                                       │
│    │ >/< │   Skills Transfer Hub.                                          │
│    ╰─────╯                                                                 │
│                                                                            │
│  Astuce : tapez `sth help` pour voir la liste des commandes.               │
│  STH gère .claude/skills depuis un dépôt distant.                          │
│                                                                            │
╰────────────────────────────────────────────────────────────────────────────╯

Utenfor TTY (omdirigert utdata, CI-kjøring) skrives bare den siste rammen ut — ingen animasjon, ingen buffer-omskrivning.

STH baserer seg på shell-miljøvariablene dine for Git-leverandører. Den generiske STH_TOKEN prøves først, etterfulgt av den leverandørspesifikke variabelen. Ingen hemmeligheter lagres i .sth/.

For CI, eksporter riktig PAT i pipeline-konteksten. Self-hosted installasjoner (GitHub Enterprise, self-managed GitLab) støttes ikke ennå — åpne et issue hvis behovet er kritisk.

STH kan oppdage skills på tre måter — velg den som passer repoet ditt.

1. SKILLS.md (eksplisitt manifest)

| Type  | Name           | Folder | Source                    | Description           |
| ----- | -------------- | ------ | ------------------------- | --------------------- |
| skill | analyse-risque | skills | skills/analyse-risque.md  | Check-list QSE        |
| agent | reviewer       | agents | agents/reviewer.md        | Revue de PR auto      |

2. Auto-deteksjon (pakker)

Hvis repoet ditt følger konvensjonen category/folder/SKILL.md, oppdager STH pakker automatisk:

react/form-wizard/SKILL.md         → bundle "react/form-wizard"
react/form-wizard/templates/...    → tous les fichiers synchronisés
commands/release-helper/SKILL.md   → bundle "commands/release-helper"

3. Enterprise / multi-stack oppsett

For større repoer som samler flere artefakttyper (skills, agenter, kommandoer, språkbundne instruksjoner) i én sannhetskilde, leverer STH en dedikert multi-stack-skanner. Typisk oppsett:

acme-skills/
├── manifest.json                       ← marqueur multi-stack
├── skills/
│   └── form-wizard/SKILL.md
├── agents/
│   └── reviewer.md                     ← frontmatter
├── commands/
│   ├── release-helper.md               ← fichier unique
│   └── fix-pr/SKILL.md                 ← variante skill-style
└── go/
    └── instructions/
        └── error-handling.instructions.md

• skills/[name]/SKILL.md — komplette skills med egen mappe (maler, ressurser, osv.).
• agents/[name].md — enkeltfil-agenter deklarert med frontmatter.
• commands/[name].md eller commands/[name]/SKILL.md — enkeltfil- eller skill-stil kommandoer.
• [lang]/instructions/[name].instructions.md — språkbundne instruksjoner (Copilot-stil).

STH bytter til multi-stack-skanneren når en manifest.json ligger i repo-roten, eller når minst to av de fire konvensjonelle containerne ovenfor er til stede.

STH kan skrive installerte ressurser til ett eller flere AI-verktøymål. Auto-deteksjonen ser etter den konvensjonelle markørfilen for hvert verktøy — aldri et tvetydig overordnet katalog — slik at STH bare foreslår et mål når det finnes solid bevis. Veiviseren viser oppdagede mål og lar deg ha siste ord.

Du kan installere ressurser til flere mål i samme prosjekt — STH skriver hver fil under riktig rotkatalog. Hvis ingen mål oppdages automatisk, faller STH tilbake til Claude som standard.

Buddy gir deg prosjekttilstanden med et øyekast. Med --watch reagerer den live på filendringer.

• 💧  >/< — Alt er oppdatert
• ⚠️  o.O — Oppdatering tilgjengelig
• 😶  ._. — Ingen konfigurasjon
• ❌  x x — Feil
• ⏳  >_< — Pågår
• ✅  ^.^ — Ferdig

Konfigurasjonen ligger i prosjektroten, i .sth/project.json. Du kan committe den trygt — den inneholder aldri hemmeligheter. Schema v2 støtter flere leverandører i providers-arrayen, hver med sin egen target_dir.

{
  "schema_version": 2,
  "providers": [
    {
      "id": "team-skills",
      "provider": "github",
      "repository_id": "acme-corp/skills",
      "catalog_ref": "main",
      "catalog_path": "SKILLS.md",
      "target_dir": ".claude/skills"
    },
    {
      "id": "shared-prompts",
      "provider": "gitlab",
      "repository_id": "acme/shared-prompts",
      "catalog_ref": "main",
      "catalog_path": "manifest.json",
      "target_dir": ".github/instructions"
    }
  ],
  "resources": [
    {
      "catalog_id": "skill::react::form-wizard",
      "provider_id": "team-skills",
      "pinned_ref": "v1.4.0"
    },
    {
      "catalog_id": "command::release-helper",
      "provider_id": "shared-prompts"
    }
  ]
}

Schema v2 støtter flere leverandører og flere målmapper i samme prosjekt. Hver ressurs refererer kildeleverandøren via provider_id, og hver leverandør deklarerer sin egen target_dir — du kan hente React-skills fra et privat GitHub-repo til .claude/skills og samtidig delte prompts fra et GitLab-prosjekt til .github/instructions.

Installasjonstilstanden lagres i <target_dir>/sth-state.json (f.eks. .claude/skills/sth-state.json). Per ressurs: kildeleverandør, administrerte filer, deres SHA-256-hasher og status. sth status sammenligner disk mot dette manifestet for å oppdage lokale endringer.

STH er i offentlig Alpha. For å holde omfanget tydelig og observerbart gjelder noen midlertidige regler:

• Et prosjekt kan referere til kun ett privat Git-repo om gangen (github, gitlab, azure-devops eller bitbucket) — offentlige repoer er ubegrenset.
• Nødforbikobling: STH_ALPHA_GATE=0 deaktiverer denne CLI-siders restriksjonen (på egen risiko — støttes ikke for feilrapporter).
• Vil du teste de betalte alternativene under Alpha? Kjør sth alpha request (en konto kreves — sth login). STH-teamet vurderer hver forespørsel og godkjenner eller avslår den.
• Telemetri er et eksplisitt brukervalg satt ved sth init med tre modi — off, anonymous, connected. Se telemetriretningslinjene for hva som sendes i hvert modus og hvordan du kan ombestemme deg senere via sth telemetry.

Disse reglene faller bort ved slutten av beta. Hvis en av dem er en blokkering for deg, opprett en issue — saken din kan flytte tidsplanen.