Dokumentaatio

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

Vaiheet tap ja trust tehdään vain kerran — trust on Homebrew 6.0:n turvaportti kolmannen osapuolen tapeille. Päivitä sen jälkeen STH komennolla brew upgrade sth, älä komennolla sth update self.

Windows — winget tai 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ääri GitHub Releasesista

Jos suosit manuaalista asennusta tai olet alustalla, jota ei tueta, lataa vastaava arkisto Releases-sivulta (kukin arkisto sisältää SHA256SUMS-tiedoston eheyden tarkistamiseksi), ja sijoita binääri PATH-muuttujaasi.

# 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%

Vahvista asennus

sth version

Projektisi juurihakemistosta (yleensä kansio, joka sisältää jo .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

Konfiguraatio kirjoitetaan tiedostoon .sth/project.json (schema v2). Salaisuuksia ei tallenneta — STH lukee Git-tokenit ympäristöstäsi.

sth ilman argumenttia interaktiivisessa terminaalissa avaa ohjatun valikon ja ehdottaa seuraavaa hyödyllistä toimintoa (init, list, install, update, buddy…).

sth ilman argumenttia interaktiivisessa terminaalissa toistaa lyhyen herätysanimaation — 💤 sitten 👀 — ja jäädyttää Buddyn projektin todelliseen tilaan. Kaikki 78 merkin levyisessä kehyksessä.

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

TTY:n ulkopuolella (uudelleenohjattu tulostus, CI-suoritus) tulostetaan vain lopullinen ruutu — ei animaatiota, ei puskurin uudelleenkirjoitusta.

STH tukeutuu shell-ympäristömuuttujiisi Git-palveluntarjoajille. Yleinen STH_TOKEN kokeillaan ensin, sitten palveluntarjoajakohtainen muuttuja. Mitään salaisuuksia ei säilytetä .sth/:ssa.

CI:tä varten vie sopiva PAT putkikontekstissa. Self-hosted-asennuksia (GitHub Enterprise, self-managed GitLab) ei vielä tueta — avaa issue, jos tarve on kriittinen.

STH voi löytää skillsisi kolmella tavalla — valitse repollesi sopiva.

1. SKILLS.md (eksplisiittinen manifesti)

| 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. Automaattinen tunnistus (paketit)

Jos repo seuraa category/folder/SKILL.md -käytäntöä, STH tunnistaa paketit automaattisesti:

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

Suuremmille repoille, jotka kokoavat useita artefaktityyppejä (skillit, agentit, komennot, kielikohtaiset ohjeet) yhteen totuuden lähteeseen, STH toimittaa oman multi-stack-skannerin. Tyypillinen asettelu:

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 — täydet skillit omine kansioineen (mallit, resurssit, jne.).
• agents/[name].md — yhden tiedoston agentit, määritetty frontmatterilla.
• commands/[name].md tai commands/[name]/SKILL.md — yhden tiedoston tai skill-tyyliset komennot.
• [lang]/instructions/[name].instructions.md — kielikohtaiset ohjeet (Copilot-tyyli).

STH siirtyy multi-stack-skanneriin, kun repon juuressa on manifest.json tai vähintään kaksi yllä mainituista neljästä konventionaalisesta säiliöstä on läsnä.

STH voi kirjoittaa asennetut resurssit yhteen tai useampaan AI-työkalukohteeseen. Automaattinen tunnistus etsii jokaisen työkalun konventionaalista merkintätiedostoa — ei koskaan moniselitteistä yläkansiota — joten STH ehdottaa kohdetta vain, kun on vankka näyttö. Ohjattu toiminto näyttää tunnistetut kohteet ja antaa sinulle viimeisen sanan.

Voit asentaa resursseja useisiin kohteisiin samassa projektissa — STH kirjoittaa jokaisen tiedoston vastaavan juuren alle. Jos kohdetta ei tunnisteta automaattisesti, STH palaa Claude-oletukseen.

Buddy näyttää projektin tilan yhdellä silmäyksellä. --watch-lipulla se reagoi tiedostomuutoksiin reaaliajassa.

• 💧  >/< — Kaikki on ajan tasalla
• ⚠️  o.O — Päivitys saatavilla
• 😶  ._. — Ei konfiguraatiota
• ❌  x x — Virhe
• ⏳  >_< — Käynnissä
• ✅  ^.^ — Valmis

Konfiguraatio sijaitsee projektisi juuressa, tiedostossa .sth/project.json. Voit committaa sen turvallisesti — se ei sisällä salaisuuksia. Schema v2 tukee useita palveluntarjoajia providers-taulukossa, kullakin oma 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 tukee useita palveluntarjoajia ja useita kohdekansioita samassa projektissa. Jokainen resurssi viittaa lähdepalveluntarjoajaansa provider_id-kentällä, ja jokainen palveluntarjoaja määrittää oman target_dir-arvonsa — voit vetää React-skillejä yksityisestä GitHub-reposta hakemistoon .claude/skills ja samalla jaettuja kehotteita GitLab-projektista hakemistoon .github/instructions.

Asennustila tallennetaan tiedostoon <target_dir>/sth-state.json (esim. .claude/skills/sth-state.json). Per resurssi: lähde-palveluntarjoaja, hallinnoidut tiedostot, niiden SHA-256-hashit ja tila. sth status vertaa levyä tähän manifestiin paikallisten muutosten havaitsemiseksi.

STH on julkisessa Alpha-vaiheessa. Jotta laajuus pysyy selkeänä ja havaittavana, käytössä on muutamia väliaikaisia sääntöjä:

• Projekti voi viitata vain yhteen yksityiseen Git-repoon kerrallaan (github, gitlab, azure-devops tai bitbucket) — julkiset repot ovat rajattomat.
• Hätäohitus: STH_ALPHA_GATE=0 poistaa tämän CLI-puolen rajoituksen käytöstä (omalla vastuulla — ei tueta vikailmoituksissa).
• Haluatko kokeilla maksullisia ominaisuuksia Alphan aikana? Suorita sth alpha request (tili vaaditaan — sth login). STH-tiimi käsittelee jokaisen pyynnön ja hyväksyy tai hylkää sen.
• Telemetria on käyttäjän nimenomainen valinta, joka tehdään sth init -komennossa kolmella vaihtoehdolla — off, anonymous, connected. Katso telemetriakäytännöstä, mitä kussakin tilassa lähetetään ja miten muutat mieltäsi myöhemmin komennolla sth telemetry.

Nämä säännöt poistuvat beta-vaiheen lopussa. Jos jokin niistä on este sinulle, avaa issue — tapauksesi voi muuttaa aikataulua.