Erklärung der Installationsquellen

Was Sie nach dieser Lektion können

Skills auf drei Arten installieren: GitHub-Repository, lokaler Pfad, privates Git-Repository
Die für Ihr Szenario am besten geeignete Installationsquelle auswählen
Vor- und Nachteile sowie Überlegungen für verschiedene Quellen verstehen
GitHub shorthand, relative Pfade, private Repository-URLs und andere Formate beherrschen

Voraussetzungen

Dieses Tutorial setzt voraus, dass Sie bereits Den ersten Skill installieren abgeschlossen haben und den grundlegenden Installationsprozess kennen.

Ihr aktuelles Problem

Sie haben wahrscheinlich bereits gelernt, wie Sie Skills aus dem offiziellen Repository installieren, aber:

Kann man nur GitHub verwenden?: Sie möchten GitLab-Repositories Ihres Unternehmens verwenden, wissen aber nicht, wie Sie es konfigurieren
Wie installiert man lokal entwickelte Skills?: Sie entwickeln gerade Ihre eigenen Skills und möchten diese zuerst lokal testen
Einen bestimmten Skill direkt angeben: Das Repository enthält viele Skills, und Sie möchten nicht jedes Mal über die interaktive Oberfläche auswählen
Wie greift man auf private Repositories zu?: Das Skill-Repository Ihres Unternehmens ist privat, und Sie wissen nicht, wie Sie sich authentifizieren

Tatsächlich unterstützt OpenSkills verschiedene Installationsquellen. Schauen wir uns diese nacheinander an.

Wann Sie diesen Ansatz verwenden

Anwendungsszenarien für verschiedene Installationsquellen:

Installationsquelle	Anwendungsszenario	Beispiel
GitHub-Repository	Verwendung von Skills aus der Open-Source-Community	`openskills install anthropics/skills`
Lokaler Pfad	Entwicklung und Test eigener Skills	`openskills install ./my-skill`
Privates Git-Repository	Verwendung interner Skills des Unternehmens	`openskills install [email protected]:my-org/private-skills.git`

Empfohlene Vorgehensweise

Open-Source-Skills: Installieren Sie vorzugsweise aus GitHub-Repositories, um Updates einfach durchzuführen
Entwicklungsphase: Installieren Sie aus lokalen Pfaden, um Änderungen in Echtzeit zu testen
Team-Zusammenarbeit: Verwenden Sie private Git-Repositories, um interne Skills zentral zu verwalten

Kernkonzept: Drei Quellen, derselbe Mechanismus

Obwohl die Installationsquellen unterschiedlich sind, ist der zugrunde liegende Mechanismus von OpenSkills derselbe:

[Quellentyp erkennen] → [Skill-Dateien abrufen] → [In .claude/skills/ kopieren]

Quellenerkennungslogik (Quellcode install.ts:25-45):

typescript

function isLocalPath(source: string): boolean {
  return (
    source.startsWith('/') ||
    source.startsWith('./') ||
    source.startsWith('../') ||
    source.startsWith('~/')
  );
}

function isGitUrl(source: string): boolean {
  return (
    source.startsWith('git@') ||
    source.startsWith('git://') ||
    source.startsWith('http://') ||
    source.startsWith('https://') ||
    source.endsWith('.git')
  );
}

Erkennungspriorität:

Zuerst prüfen, ob es sich um einen lokalen Pfad handelt (isLocalPath)
Dann prüfen, ob es sich um eine Git-URL handelt (isGitUrl)
Zuletzt als GitHub shorthand behandeln (owner/repo)

Mitmachen

Methode 1: Aus GitHub-Repository installieren

Anwendungsszenario: Installation von Skills aus der Open-Source-Community, wie dem offiziellen Anthropic-Repository oder Skill-Paketen von Drittanbietern.

Grundlegende Verwendung: Ganzen Repository installieren

bash

npx openskills install owner/repo

Beispiel: Skills aus dem offiziellen Anthropic-Repository installieren

bash

npx openskills install anthropics/skills

Sie sollten sehen:

Installing from: anthropics/skills
Location: project (.claude/skills)

Cloning repository...
✓ Repository cloned

Found 4 skill(s)

? Select skills to install:
❯ ◉ pdf (24 KB)
  ◯ git-workflow (12 KB)
  ◯ check-branch-first (8 KB)
  ◯ skill-creator (16 KB)

Erweiterte Verwendung: Unterpfad angeben (einen bestimmten Skill direkt installieren)

Wenn das Repository viele Skills enthält, können Sie direkt den Unterpfad des zu installierenden Skills angeben und die interaktive Auswahl überspringen:

bash

npx openskills install owner/repo/skill-name

Beispiel: PDF-Verarbeitungsskill direkt installieren

bash

npx openskills install anthropics/skills/pdf

Sie sollten sehen:

Installing from: anthropics/skills/pdf
Location: project (.claude/skills)

Cloning repository...
✓ Repository cloned
✅ Installed: pdf
   Location: /path/to/project/.claude/skills/pdf

Empfohlene Vorgehensweise

Wenn Sie nur einen Skill aus einem Repository benötigen, können Sie das Unterpfad-Format verwenden, um die interaktive Auswahl zu überspringen und schneller zu arbeiten.

GitHub shorthand-Regeln (Quellcode `install.ts:131-143`)

Format	Beispiel	Konvertierungsergebnis
`owner/repo`	`anthropics/skills`	`https://github.com/anthropics/skills`
---	---	---

Methode 2: Aus lokalem Pfad installieren

Anwendungsszenario: Sie entwickeln gerade Ihre eigenen Skills und möchten diese lokal testen, bevor Sie sie auf GitHub veröffentlichen.

Absoluten Pfad verwenden

bash

npx openskills install /absolute/path/to/skill

Beispiel: Skills aus dem Skill-Verzeichnis im Home-Verzeichnis installieren

bash

npx openskills install ~/dev/my-skills/pdf-processor

Relativen Pfad verwenden

bash

npx openskills install ./local-skills/my-skill

Beispiel: Aus dem Unterverzeichnis local-skills/ im Projektverzeichnis installieren

bash

npx openskills install ./local-skills/web-scraper

Sie sollten sehen:

Installing from: ./local-skills/web-scraper
Location: project (.claude/skills)
✅ Installed: web-scraper
   Location: /path/to/project/.claude/skills/web-scraper

Wichtige Hinweise

Die Installation über lokale Pfade kopiert die Skill-Dateien in .claude/skills/. Spätere Änderungen an den Quelldateien werden nicht automatisch synchronisiert. Für Updates müssen Sie erneut installieren.

Lokales Verzeichnis mit mehreren Skills installieren

Wenn Ihre lokale Verzeichnisstruktur so aussieht:

local-skills/
├── pdf-processor/SKILL.md
├── web-scraper/SKILL.md
└── git-helper/SKILL.md

Sie können das gesamte Verzeichnis direkt installieren:

bash

npx openskills install ./local-skills

Dadurch wird eine interaktive Auswahl-Oberfläche gestartet, über die Sie die zu installierenden Skills auswählen können.

Unterstützte Formate für lokale Pfade (Quellcode `install.ts:25-32`)

Format	Beschreibung	Beispiel
`/absolute/path`	Absoluter Pfad	`/home/user/skills/my-skill`
`./relative/path`	Relativer Pfad zum aktuellen Verzeichnis	`./local-skills/my-skill`
`../relative/path`	Relativer Pfad zum übergeordneten Verzeichnis	`../shared-skills/common`
`~/path`	Relativer Pfad zum Home-Verzeichnis	`~/dev/my-skills`

Entwickler-Tipp

Mit der ~-Abkürzung können Sie schnell auf Skills im Home-Verzeichnis verweisen, was sich gut für persönliche Entwicklungsumgebungen eignet.

Methode 3: Aus privatem Git-Repository installieren

Anwendungsszenario: Verwendung interner GitLab/Bitbucket-Repositories oder privater GitHub-Repositories Ihres Unternehmens.

SSH-Methode (empfohlen)

bash

npx openskills install [email protected]:owner/private-skills.git

Beispiel: Aus privatem GitHub-Repository installieren

bash

npx openskills install [email protected]:my-org/internal-skills.git

Sie sollten sehen:

Installing from: [email protected]:my-org/internal-skills.git
Location: project (.claude/skills)

Cloning repository...
✓ Repository cloned

Found 3 skill(s)
? Select skills to install:

Authentifizierungskonfiguration

Die SSH-Methode erfordert, dass Sie bereits SSH-Schlüssel konfiguriert haben. Wenn das Klonen fehlschlägt, überprüfen Sie bitte:

bash

# SSH-Verbindung testen
ssh -T [email protected]

# Wenn die Meldung "Hi username! You've successfully authenticated..." angezeigt wird, ist die Konfiguration korrekt

HTTPS-Methode (Anmeldeinformationen erforderlich)

bash

npx openskills install https://github.com/owner/private-skills.git

HTTPS-Authentifizierung

Beim Klonen privater Repositories über HTTPS fordert Git zur Eingabe von Benutzername und Passwort (oder Personal Access Token) auf. Wenn Sie Zwei-Faktor-Authentifizierung verwenden, müssen Sie einen Personal Access Token statt des Kontopassworts verwenden.

Andere Git-Hosting-Plattformen

GitLab (SSH):

bash

npx openskills install [email protected]:owner/skills.git

GitLab (HTTPS):

bash

npx openskills install https://gitlab.com/owner/skills.git

Bitbucket (SSH):

bash

npx openskills install [email protected]:owner/skills.git

Bitbucket (HTTPS):

bash

npx openskills install https://bitbucket.org/owner/skills.git

Empfohlene Vorgehensweise

Für interne Team-Skills wird empfohlen, private Git-Repositories zu verwenden. Dies hat folgende Vorteile:

Alle Teammitglieder können aus derselben Quelle installieren
Zum Aktualisieren von Skills仅需 openskills update
Einfache Versionsverwaltung und Berechtigungssteuerung

Git-URL-Erkennungsregeln (Quellcode `install.ts:37-45`)

Präfix/Suffix	Beschreibung	Beispiel
`git@`	SSH-Protokoll	`[email protected]:owner/repo.git`
`git://`	Git-Protokoll	`git://github.com:owner/repo.git`
`http://`	HTTP-Protokoll	`http://github.com/owner/repo.git`
`https://`	HTTPS-Protokoll	`https://github.com/owner/repo.git`
`.git`-Suffix	Git-Repository (beliebiges Protokoll)	`owner/repo.git`

Checkpoint ✅

Nach Abschluss dieser Lektion bestätigen Sie bitte:

[ ] Sie wissen, wie Sie Skills aus GitHub-Repositories installieren (owner/repo-Format)
[ ] Sie wissen, wie Sie einen bestimmten Skill aus einem Repository direkt installieren (owner/repo/skill-name)
[ ] Sie wissen, wie Sie Skills aus lokalen Pfaden installieren (./, ~/ usw.)
[ ] Sie wissen, wie Sie Skills aus privaten Git-Repositories installieren (SSH/HTTPS)
[ ] Sie verstehen die Anwendungsszenarien für verschiedene Installationsquellen

Warnhinweise zu Fallstricken

Problem 1: Lokaler Pfad existiert nicht

Phänomen:

Error: Path does not exist: ./local-skills/my-skill

Ursache:

Tippfehler im Pfad
Falsche Berechnung des relativen Pfads

Lösung:

Prüfen Sie, ob der Pfad existiert: ls ./local-skills/my-skill
Verwenden Sie einen absoluten Pfad, um Verwirrung mit relativen Pfaden zu vermeiden

Problem 2: Klonen privaten Repository fehlgeschlagen

Phänomen:

✗ Failed to clone repository
fatal: repository '[email protected]:owner/private-skills.git' does not appear to be a git repository

Ursache:

SSH-Schlüssel nicht konfiguriert
Keine Zugriffsberechtigung für das Repository
Falsche Repository-Adresse

Lösung:

SSH-Verbindung testen: ssh -T [email protected]
Bestätigen Sie, dass Sie Zugriff auf das Repository haben
Überprüfen Sie, ob die Repository-Adresse korrekt ist

Hinweis

Für private Repositories zeigt das Tool den folgenden Hinweis an (Quellcode install.ts:167):

Tip: For private repos, ensure git SSH keys or credentials are configured

Problem 3: SKILL.md im Unterpfad nicht gefunden

Phänomen:

Error: SKILL.md not found at skills/my-skill

Ursache:

Unterpfad falsch
Die Verzeichnisstruktur im Repository entspricht nicht Ihren Erwartungen

Lösung:

Installieren Sie zunächst das gesamte Repository ohne Unterpfad: npx openskills install owner/repo
Überprüfen Sie über die interaktive Oberfläche die verfügbaren Skills
Installieren Sie erneut mit dem korrekten Unterpfad

Problem 4: GitHub shorthand-Erkennungsfehler

Phänomen:

Error: Invalid source format
Expected: owner/repo, owner/repo/skill-name, git URL, or local path

Ursache:

Format entspricht keiner Regel
Tippfehler (z. B. Leerzeichen in owner / repo)

Lösung:

Prüfen Sie, ob das Format korrekt ist (keine Leerzeichen, korrekte Anzahl von Schrägstrichen)
Verwenden Sie die vollständige Git-URL anstatt des shorthand

Zusammenfassung der Lektion

In dieser Lektion haben Sie gelernt:

Drei Installationsquellen: GitHub-Repository, lokaler Pfad, privates Git-Repository
GitHub shorthand: Zwei Formate: owner/repo und owner/repo/skill-name
Lokale Pfadformate: Absoluter Pfad, relativer Pfad, Home-Verzeichnis-Abkürzung
Installation privater Repositories: SSH- und HTTPS-Methoden, Formatierung für verschiedene Plattformen
Quellenerkennungslogik: Wie das Tool erkennt, welchen Installationsquellentyp Sie angeben

Schnellreferenz für Kernbefehle:

Befehl	Funktion
`npx openskills install owner/repo`	Aus GitHub-Repository installieren (interaktive Auswahl)
`npx openskills install owner/repo/skill-name`	Einen bestimmten Skill aus dem Repository direkt installieren
`npx openskills install ./local-skills/skill`	Aus lokalem Pfad installieren
`npx openskills install ~/dev/my-skills`	Aus Home-Verzeichnis installieren
`npx openskills install [email protected]:owner/private-skills.git`	Aus privatem Git-Repository installieren

Vorschau auf die nächste Lektion

In der nächsten Lektion lernen wir Globale Installation vs. projektlokale Installation.
Sie werden lernen:
Die Funktion des Flags --global und der Installationsort
Den Unterschied zwischen globaler Installation und projektlokaler Installation
Die Wahl des geeigneten Installationsorts je nach Szenario
Best Practices für die gemeinsame Nutzung von Skills über mehrere Projekte

Installationsquellen sind nur ein Teil der Skill-Verwaltung. Als Nächstes müssen wir verstehen, wie der Installationsort von Skills Auswirkungen auf das Projekt hat.

Anhang: Quellcode-Referenz

Klicken Sie hier, um den Quellcode-Standort anzuzeigen

Aktualisierungszeit: 2026-01-24

Funktion	Dateipfad	Zeilennummer
Installationsbefehl-Einstieg	`src/commands/install.ts`	83-184
Lokaler Pfad-Erkennung	`src/commands/install.ts`	25-32
Git-URL-Erkennung	`src/commands/install.ts`	37-45
GitHub shorthand-Parsing	`src/commands/install.ts`	131-143
Lokaler Pfad-Installation	`src/commands/install.ts`	199-226
Git-Repository-Klonen	`src/commands/install.ts`	155-169
Fehlermeldung privates Repository	`src/commands/install.ts`	167

Wichtige Funktionen:

isLocalPath(source) - Prüft, ob es sich um einen lokalen Pfad handelt (Zeilen 25-32)
isGitUrl(source) - Prüft, ob es sich um eine Git-URL handelt (Zeilen 37-45)
installFromLocal() - Installiert Skills aus einem lokalen Pfad (Zeilen 199-226)
installSpecificSkill() - Installiert einen Skill am angegebenen Unterpfad (Zeilen 272-316)
getRepoName() - Extrahiert den Repository-Namen aus einer Git-URL (Zeilen 50-56)

Wichtige Logik:

Priorität bei der Erkennung von Quellentypen: lokaler Pfad → Git-URL → GitHub shorthand (Zeilen 111-143)
GitHub shorthand unterstützt zwei Formate: owner/repo und owner/repo/skill-name (Zeilen 132-142)
Bei Fehlschlagen des Klonens privater Repositories wird zur Konfiguration von SSH-Schlüsseln oder Anmeldeinformationen aufgefordert (Zeile 167)

Erklärung der Installationsquellen ​

Was Sie nach dieser Lektion können ​

Ihr aktuelles Problem ​

Wann Sie diesen Ansatz verwenden ​

Kernkonzept: Drei Quellen, derselbe Mechanismus ​

Mitmachen ​

Methode 1: Aus GitHub-Repository installieren ​

Grundlegende Verwendung: Ganzen Repository installieren ​

Erweiterte Verwendung: Unterpfad angeben (einen bestimmten Skill direkt installieren) ​

GitHub shorthand-Regeln (Quellcode install.ts:131-143) ​

Methode 2: Aus lokalem Pfad installieren ​

Absoluten Pfad verwenden ​

Relativen Pfad verwenden ​

Lokales Verzeichnis mit mehreren Skills installieren ​

Unterstützte Formate für lokale Pfade (Quellcode install.ts:25-32) ​

Methode 3: Aus privatem Git-Repository installieren ​

SSH-Methode (empfohlen) ​

HTTPS-Methode (Anmeldeinformationen erforderlich) ​

Andere Git-Hosting-Plattformen ​

Git-URL-Erkennungsregeln (Quellcode install.ts:37-45) ​

Checkpoint ✅ ​

Warnhinweise zu Fallstricken ​

Problem 1: Lokaler Pfad existiert nicht ​

Problem 2: Klonen privaten Repository fehlgeschlagen ​

Problem 3: SKILL.md im Unterpfad nicht gefunden ​

Problem 4: GitHub shorthand-Erkennungsfehler ​

Zusammenfassung der Lektion ​

Vorschau auf die nächste Lektion ​

Anhang: Quellcode-Referenz ​

Erklärung der Installationsquellen

Was Sie nach dieser Lektion können

Ihr aktuelles Problem

Wann Sie diesen Ansatz verwenden

Kernkonzept: Drei Quellen, derselbe Mechanismus

Mitmachen

Methode 1: Aus GitHub-Repository installieren

Grundlegende Verwendung: Ganzen Repository installieren

Erweiterte Verwendung: Unterpfad angeben (einen bestimmten Skill direkt installieren)

GitHub shorthand-Regeln (Quellcode `install.ts:131-143`)

Methode 2: Aus lokalem Pfad installieren

Absoluten Pfad verwenden

Relativen Pfad verwenden

Lokales Verzeichnis mit mehreren Skills installieren

Unterstützte Formate für lokale Pfade (Quellcode `install.ts:25-32`)

Methode 3: Aus privatem Git-Repository installieren

SSH-Methode (empfohlen)

HTTPS-Methode (Anmeldeinformationen erforderlich)

Andere Git-Hosting-Plattformen

Git-URL-Erkennungsregeln (Quellcode `install.ts:37-45`)

Checkpoint ✅

Warnhinweise zu Fallstricken

Problem 1: Lokaler Pfad existiert nicht

Problem 2: Klonen privaten Repository fehlgeschlagen

Problem 3: SKILL.md im Unterpfad nicht gefunden

Problem 4: GitHub shorthand-Erkennungsfehler

Zusammenfassung der Lektion

Vorschau auf die nächste Lektion

Anhang: Quellcode-Referenz