min-pilot

min-pilot installerer delte agentferdigheter og agentprofiler fra et Git-repositorium. Kilden kan ligge hos Bitbucket, GitHub, GitLab, Azure DevOps eller en annen Git-vert. Verktøyet kopierer bare filer; det kjører aldri skript fra kilderepositoriet eller kaller leverandørspesifikke API-er.

Installering

Installer pakken globalt, eller kjør den direkte med npx:

npm install -g min-pilot
# eller
npx min-pilot install skill <name> --repo

Node.js 24 eller nyere og Git må være tilgjengelig. Kilderepositoriet må kunne klones og hentes med Git. Autentisering håndteres via brukerens vanlige SSH-nøkler eller legitimasjonshjelpere for HTTPS.

Konfigurering

Pakken inneholder ingen kilde. Konfigurer Git-URL-en til kilderepositoriet lokalt:

min-pilot config set source <git-url>
min-pilot config set ref main
min-pilot config set client copilot

MIN_PILOT_SOURCE overstyrer den konfigurerte kilden for én kjøring. ref godtar en gren, tag eller commit-hash.

Kommandoer

min-pilot list [--installed] [--json]
min-pilot install skill <name> --user|--repo [--client copilot|claude] [--ref <ref>]
min-pilot install agent <name> --user|--repo
min-pilot install collection <name> --user|--repo
min-pilot update [<name>] [--user|--repo] [--dry-run] [--force]
min-pilot status [--user|--repo] [--json]
min-pilot remove skill|agent <name> --user|--repo

Hvis installasjonsomfang ikke er angitt, blir du bare spurt om dette i en interaktiv terminal. I automatisering må du angi --user eller --repo. Avslutningskode 2 betyr ugyldig bruk; avslutningskode 3 betyr en konflikt ved oppdatering.

For Copilot installeres ferdigheter under .github/skills eller ~/.copilot/skills, og agenter under .github/agents eller ~/.copilot/agents som *.agent.md. For Claude Code installeres ferdigheter under .claude/skills, og agenter som *.md under .claude/agents; disse katalogene brukes både for omfanget til et repositorium og for brukeromfanget. Agentinnholdet kopieres uendret fordi begge formatene bruker Markdown med YAML-frontmatter.

Kildeformat

skills/<name>/SKILL.md
agents/<name>.agent.md
collections/<name>.yml

Hver ferdighet og agent må ha name og description i YAML-frontmatter. Samlinger angir ferdigheter og agenter som skal installeres sammen.

Sikkerhetsmodell

Verktøyet starter Git med argumentlister, aldri som en shell-kommando. Det avviser utrygge kilde- og ref-verdier, stiforflytning og symbolske lenker i målet som går utenfor målkatalogen. Symbolske lenker i kilden hoppes over. Tilstanden lagrer SHA-256-hasher av de nøyaktige bytene som ble installert. Ved oppdateringer brukes disse hasher til å bevare lokale endringer. --dry-run viser resultatet fra git diff --no-index, mens --force er den eksplisitte måten å overstyre dette på.

Tilstandsfilen er ~/.min-pilot/state.json for brukerinstalleringer og .github/.min-pilot-state.json eller .claude/.min-pilot-state.json for installeringer i et repositorium. Denne pakken lagrer ingen legitimasjon, telemetri, livssyklusskript eller intern kildeinformasjon.