Dokumentation

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

Stegen tap och trust görs bara en gång — trust är Homebrew 6.0:s säkerhetsspärr för tredjeparts-tappar. Uppdatera sedan STH med brew upgrade sth, inte 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 från GitHub Releases

Om du föredrar manuell installation eller är på en plattform som inte stöds, ladda ner motsvarande arkiv från sidan Releases (varje arkiv levereras med en SHA256SUMS-fil för att verifiera integritet), och placera sedan 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%

Verifiera installationen

sth version

Från din projektrot (vanligtvis en mapp som redan innehåller .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

Konfigurationen skrivs till .sth/project.json (schema v2). Inga hemligheter sparas där — STH läser Git-tokens från din miljö.

sth utan argument i en interaktiv terminal öppnar den guidade menyn och föreslår nästa användbara åtgärd (init, list, install, update, buddy…).

sth utan argument i en interaktiv terminal spelar en kort vakna-animation — 💤 sedan 👀 — och fryser sedan Buddy på projektets verkliga tillstånd. Allt i en 78 tecken bred ram.

╭────────────────────────────────────────────────────────────────────────────╮
│                                                                            │
│      💧                                                                    │
│    ╭─────╮   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.                          │
│                                                                            │
╰────────────────────────────────────────────────────────────────────────────╯

Utanför TTY (omdirigerad utdata, CI-körning) skrivs endast den sista bilden ut — ingen animation, ingen buffer-omskrivning.

STH förlitar sig på dina shell-miljövariabler för Git-leverantörer. Den generiska STH_TOKEN testas först, följt av den leverantörsspecifika variabeln. Inga hemligheter sparas i .sth/.

För CI, exportera lämplig PAT i pipeline-kontexten. Self-hosted installationer (GitHub Enterprise, self-managed GitLab) stöds inte ännu — öppna ett issue om behovet är kritiskt.

STH kan upptäcka dina skills på tre sätt — välj det som passar ditt repo.

1. SKILLS.md (explicit 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-detektering (paket)

Om ditt repo följer konventionen category/folder/SKILL.md, upptäcker STH paket automatiskt:

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-layouter

För större repon som samlar flera typer av artefakter (skills, agenter, kommandon, språkbundna instruktioner) i en enda sanningskälla, levererar STH en dedikerad multi-stack-scanner. Typisk layout:

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 — kompletta skills med egen mapp (mallar, resurser, osv.).
• agents/[name].md — enkelfil-agenter deklarerade med frontmatter.
• commands/[name].md eller commands/[name]/SKILL.md — enkelfil- eller skill-stil-kommandon.
• [lang]/instructions/[name].instructions.md — språkbundna instruktioner (Copilot-stil).

STH växlar till multi-stack-scannern när en manifest.json ligger i repo-roten, eller när minst två av de fyra konventionella behållarna ovan finns på plats.

STH kan skriva installerade resurser till ett eller flera AI-verktygsmål. Auto-detekteringen letar efter den konventionella markörfilen för varje verktyg — aldrig en tvetydig överordnad katalog — så STH föreslår bara ett mål när det finns solida bevis. Guiden visar upptäckta mål och låter dig ha sista ordet.

Du kan installera resurser till flera mål i samma projekt — STH skriver varje fil under rätt rot. Om inget mål upptäcks automatiskt återgår STH till Claude som standard.

Buddy ger dig projekttillståndet med ett ögonkast. Med --watch reagerar den live på filändringar.

• 💧  >/< — Allt är aktuellt
• ⚠️  o.O — Uppdatering tillgänglig
• 😶  ._. — Ingen konfiguration
• ❌  x x — Fel
• ⏳  >_< — Pågår
• ✅  ^.^ — Klar

Konfigurationen ligger i projektets rot, i .sth/project.json. Du kan committa den säkert — den innehåller aldrig hemligheter. Schema v2 stöder flera leverantörer i providers-arrayen, var och en 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öder flera leverantörer och flera målmappar i samma projekt. Varje resurs refererar sin källleverantör via provider_id, och varje leverantör deklarerar sin egen target_dir — du kan hämta React-skills från ett privat GitHub-repo till .claude/skills och samtidigt delade prompts från ett GitLab-projekt till .github/instructions.

Installationstillståndet lagras i <target_dir>/sth-state.json (t.ex. .claude/skills/sth-state.json). Per resurs: källprovider, hanterade filer, deras SHA-256-hashar och status. sth status jämför disk mot detta manifest för att upptäcka lokala ändringar.

STH är i öppen Alpha. För att hålla omfattningen tydlig och observerbar gäller några tillfälliga regler:

• Ett projekt kan referera till endast ett privat Git-repo i taget (github, gitlab, azure-devops eller bitbucket) — offentliga repon är obegränsade.
• Nödforcering: STH_ALPHA_GATE=0 inaktiverar denna CLI-sidans begränsning (på egen risk — stöds inte vid bugg-rapporter).
• Vill du testa de betalda alternativen under Alpha? Kör sth alpha request (ett konto krävs — sth login). STH-teamet granskar varje begäran och godkänner eller avslår den.
• Telemetri är ett uttryckligt användarval som görs vid sth init med tre lägen — off, anonymous, connected. Se telemetripolicyn för vad som skickas i varje läge och hur du ändrar dig senare via sth telemetry.

Dessa regler försvinner i slutet av beta-fasen. Om någon av dem är ett hinder, öppna ett issue — ditt fall kan flytta tidsplanen.