jiweibo/skillshare

Skillshare CLI

Verwenden Sie Skillshare, um eine Quelle zu pflegen und Ressourcen auf konfigurierte Ziele zu verteilen. Lesen Sie nur die Referenz, die für die angeforderte Operation relevant ist; die Routing-Tabelle befindet sich unten. Überprüfen Sie skillshare <command> --help, falls die installierte Version von diesen Beispielen abweicht.

Umfang und Ressourcenauswahl

• Globale Konfiguration: ~/.config/skillshare/config.yaml. Projektkonfiguration: .skillshare/config.yaml oder skillshare/config.yaml; die verborgene Datei gewinnt, wenn beide existieren. Verwenden Sie explizit -g oder -p, wenn der Speicherort wichtig ist, anstatt sich auf die automatische Erkennung zu verlassen.
• Skills sind Verzeichnisse, die SKILL.md enthalten; Agents sind einzelne Markdown-Dateien. Quellpfade können angepasst werden. Verwenden Sie die konfigurierten Quellen anstatt Standardwerte anzunehmen.
• Nachverfolgte Kopien skills/<bekannter-agent>/<skill-pfad>/SKILL.md bilden einen logischen Skill pro Repository/Präfix/Suffix. Merge/Copy wählen die genaue Agent-Variante (einschließlich Aliase und Konto-Identität agent:). Erkennung erfordert dasselbe Suffix unter zwei verschiedenen kanonischen Agents. Kompatible Ziele, die einen Ordner teilen, wählen die Vereinigungsmenge ihrer Agent-Identitäten; ein universelles Ziel allein impliziert keinen Agent. Der Status zählt logische Skills und physische Varianten; Listen- und Synchronisationsoperationen behalten physische Namen bei. Explizite Ziele/Überschreibungen und physische Filter gelten weiterhin. Der Symlink-Modus für ganze Verzeichnisse zeigt alle Varianten an. Siehe sync.md.
• Verwenden Sie native Agent-Ziele für Agents. Verwenden Sie Extras für beliebige Dateiressourcen oder wenn eine Glättung/Inhaltsumwandlung erforderlich ist; extension: funktioniert nur auf Extras-Zielen.
• Gemeinsame Speicher-Notizen befinden sich im Extra memory. Verwenden Sie extras memory, um Markdown-Notizen und Lesehinweise zu verwalten; verschachtelte Pfade wie wiki/architecture.md werden unterstützt. Lesen Sie extras.md für Umfang, Versionsüberprüfungen und Agent-Einrichtung. Für eine Sitzungsretrospektive oder Träumen über gespeicherte Notizen lesen Sie memory-review.md. Der Host-Agent führt die Überprüfung durch; Skillshare startet oder plant niemals einen Agent.
• MCP verwendet eigene Empfangsziele und Quellendefinitionen. Lesen Sie mcp.md, bevor Sie MCP-Einstellungen bearbeiten oder native Konfigurationen importieren. Die Agent-Notizen behandeln, was für Claude Code, Codex, OpenCode und Pi spezifisch ist: Bereiche und Dateien, Namen und Anmeldedaten, die sie ablehnen, Pi's integriertes MCP und piOptions, OMP's natives MCP und bewahrte Aktivierungs-/Deaktivierungslisten, die portable tools-Politik, Upgrade von Pi-Einstellungen von 0.22, Deaktivieren eines globalen Servers in einem Projekt, mcp.projects für viele Ordner von einer Konfiguration und mcp serve für Agents, die nicht auf die synchronisierten Skill-Ordner zugreifen können.
• Plugins halten ihre nativen Komponenten zusammen. Lesen Sie plugins.md für Installation, Import, Sync-Auswahl, Updates und native Kompatibilitätsgrenzen für Claude, Codex, Cursor, Antigravity, Pi, OMP und OpenCode, einschließlich Pi-Paketen von pi.dev und OMP-Marketplace-Plugins und eigenständiger Erweiterungsauswahl.
• Hooks bewahren die native Ereigniskarte jedes Agent oder den Erweiterungs-/Plugin-Code. Lesen Sie hooks.md vor Import, Synchronisation oder Wiederherstellung.

Ausführungsregeln

1. Nichtinteraktive Eingaben wählen. Geben Sie Namen und Auswahl-Flags an, die vom jeweiligen Befehl unterstützt werden. Verwenden Sie --no-tui für einfache Ausgabe oder --json, wo unterstützt. Fügen Sie --force nicht einfach hinzu, um eine Eingabeaufforderung zu vermeiden: Es kann Konflikte überschreiben oder Audits überschreiben.
2. Vorschau von Schreibvorgängen trennen. Verwenden Sie --dry-run, wo unterstützt. Nach dem Ändern von Skills oder Agents synchronisieren Sie die gewünschte Ressource und den Bereich. MCP- und Hooks-Mutationen speichern die Quelle nur, es sei denn, --sync wird angegeben; sync --all umfasst auch Extras, MCP und Hooks, schließt jedoch Plugins aus.
3. Audit-Blöcke prüfen. Überprüfen Sie die Ergebnisse, bevor Sie eine Überschreibung wählen. install --json erlaubt Überschreibung und wählt alle, wenn kein Skill/Agent-Filter angegeben ist, behält aber die Audit-Schleuse bei; es ist nicht nur ein Ausgabeformat. Lesen Sie install.md und audit.md, bevor Sie es für die Automatisierung verwenden.
4. Den passenden Wiederherstellungsmechanismus verwenden. Deinstallierte Skills werden in den Papierkorb verschoben; native MCP-Einträge verwenden MCP-Backups. Ersetzen Sie nicht die Dateisystemlöschung durch CLI-Deinstallation.
5. Anmeldedaten aus MCP-Definitionen heraushalten. Verwenden Sie {fromEnv: VARIABLE}-Referenzen. Das Verwalten von Einstellungen erfordert nicht das Auflösen von Geheimnissen, Kopieren von OAuth-Anmeldedaten, Starten von Servern oder Abfragen ihrer Tools.
6. Operationsbereich respektieren. Lokale Konfigurationsarbeit impliziert keine Berechtigung zum Committen, Pushen oder Veröffentlichen. Führen Sie diese Befehle aus, wenn sie in der Anfrage des Benutzers enthalten sind.

Allgemeine Arbeitsabläufe

Prüfen und Diagnostizieren

skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json

doctor beendet sich mit Exit-Code 1, wenn Fehler gefunden werden. Audit verwendet --format json; JSON-Flags und TUI-Verfügbarkeit variieren je nach Befehl. Siehe die entsprechende Referenz, anstatt Gleichheit anzunehmen.

Ein Upstream-Repository verfolgen oder ausgewählte Skills installieren

Wählen Sie die Ressource und den Bereich vor der Installation. Verwenden Sie -g für benutzerweite Ressourcen oder -p für dieses Projekt; behalten Sie diesen Bereich bei Vorschau, Anwenden, Aktualisieren und Synchronisieren bei.

Absicht	Befehl
Eine Upstream-Skill-Sammlung als einen Git-Checkout behalten	skillshare install owner/repo --track --name team -g
Nur benannte Skills mit ihren Quellmetadaten installieren	skillshare install owner/repo -s pdf,commit -g
Alle gefundenen Skills einzeln installieren	skillshare install owner/repo --all -g
Ein vollständiges natives Plugin verwalten, einschließlich Hooks/MCP	plugin discover und plugin add verwenden; siehe unten

Für den Arbeitsablauf Vorschau → Anwenden → Aktualisieren → Synchronisieren mit Bereich lesen Sie install.md. Es behandelt das Folgen des neuesten Upstream-Branches, abgelehnte Flag-Kombinationen und Zielfilter.

Für die Projekteinrichtung verwenden Sie init -p, dann install -p und sync -p. Rehydratieren Sie konfigurierte Remote-Abhängigkeiten mit install ohne Quelle. Für vollständige Flag-Details und Agents lesen Sie install.md und sync.md.

Um einen lokalen Skills-Checkout zu verwenden, führen Sie skillshare link <path> --enable aus, dann sync; skillshare unlink <name> entfernt nur den Link. Lesen Sie TROUBLESHOOTING.md für Informationen, wie solche Links verfolgt werden.

Deaktivieren oder Entfernen

skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync

Führen Sie die angeforderte Operation aus, nicht diese gesamte Beispielsequenz. Setzen Sie Glob-Muster in Anführungszeichen, damit Skillshare sie unverändert erhält. Deaktivieren verwendet Ignoriere-Regeln; Deinstallation verwendet den Papierkorb.

Skills in Ordner verschieben

skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync

Verwenden Sie move anstelle von mv für installierte Skills: es behält ihre Installationsdatensätze, sodass nichts erneut heruntergeladen wird. Es synchronisiert nicht; führen Sie danach sync aus. Lesen Sie install.md für Ablehnungen und den Projektmodus.

Projektordner aus der globalen Konfiguration

skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json

project verwendet immer die globale Konfiguration, auch innerhalb eines Repos; es akzeptiert -p nicht. Neue Projekte werden in config.yaml gespeichert, oder nur auf diesem Rechner mit --machine-local oder projects_storage: machine-local (--shared überschreibt die Einstellung); localize und share verschieben eines zwischen den beiden. Das Entfernen einer lokalen Kopie eines config.yaml-Projekts behält die Version von config.yaml, es sei denn, --shared wird angegeben. Bearbeitungsfilter ersetzen Listen. Das Entfernen trennt Skills und behält Agent-Dateien; JSON-Entfernung erfordert --yes, es sei denn, es wird eine Vorschau angezeigt. Lesen Sie targets.md für gespeicherte-dann-synchronisierte Fehler, Wiederholungen und partielle Entfernungsergebnisse.

MCP-Einstellungen

skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp

--target ist singulär und wiederholbar. Eine Vorschau wendet keine Änderungen an. Für Überarbeitungen, Bearbeitung, Importkonflikte, Anmeldedaten, Backups und von Menschen bediente TUI-Befehle lesen Sie mcp.md.

Komplette Plugins

Verwenden Sie plugin discover und plugin add für ein vollständiges natives Paket; plugin import übernimmt eine vorhandene native Installation. Führen Sie nur die angeforderte Operation aus. Lesen Sie plugins.md, bevor Sie Änderungen anwenden; es behandelt den Arbeitsablauf mit Bereichs-Upstream, unterstützten Zielen und Quellenref-Regeln. plugin check/update behandelt Upstream-Änderungen; sync plugins gleicht die Zielauswahl ab. Plugins sind von sync --all ausgeschlossen.

Skill-Hubs

skillshare hub add https://example.com/hub.json          # Eine Hub-Quelle speichern
skillshare hub add https://example.com/hub.json --label my-hub  # Mit benutzerdefiniertem Label
skillshare hub add [email protected]:team/skills.git --label ghe  # SSH/privat/GHE Hub-Quelle
skillshare hub list                                      # Gespeicherte Hubs auflisten
skillshare hub default my-hub                            # Standard-Hub festlegen
skillshare hub remove my-hub                             # Einen Hub entfernen
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Hub-Index erstellen

Die aktive Einstellung follow_source_links gilt auch für hub index (einschließlich --source), die integrierte Dashboard-Suche und Hub-Entwurfskandidaten.

Referenzen

Lesen Sie die passende Datei für Befehlsflags, Beispiele und Einschränkungen. Vermeiden Sie es, alle Referenzen für eine einzelne Aufgabe zu laden.

Thema	Datei
Native Agents, Auswahl, Ignoriere-Regeln und Wiederherstellung	native-agents.md
MCP-Konfiguration, Importe, TUI und Wiederherstellung	mcp.md
Native Hooks, Code-Bindungen, Bereiche und Wiederherstellung	hooks.md
Komplette Plugins, nativer Lebenszyklus und Sync-Auswahl	plugins.md
Init-Flags	init.md
Sync/Collect/Commit/Push/Pull	sync.md
Install/Update/Uninstall/Move/New	install.md
Status/Diff/List/Search/Check	status.md
Sicherheitsaudit	audit.md
Prüfung eines nicht vertrauenswürdigen Skills vor der Installation	audit-review.md
Papierkorb	trash.md
Operationsprotokoll	log.md
Ziele	targets.md
Extras (Regeln/Befehle/Prompts)	extras.md
Sitzungsretrospektiven und Träumen über gespeicherte Notizen	memory-review.md
Backup/Wiederherstellung	backup.md
Fehlerbehebung	TROUBLESHOOTING.md