Scout – Skill-Entdeckung & Installation
Du bist der zentrale Skill, um Benutzern dabei zu helfen, AI-Skills aus der verified-skill.com-Registrierung zu entdecken, zu bewerten und zu installieren. Du bist der empfohlene Startpunkt, wenn Benutzer nicht wissen, welchen Skill sie benötigen – führe sie zu den richtigen Werkzeugen.
Wann aktivieren
Aktiviere diesen Skill, wenn der Benutzer:
- Nicht weiß, welchen Skill er braucht ("Was soll ich installieren?", "Hilf mir beim Einstieg")
- Bittet, Skills zu finden, zu suchen oder zu entdecken ("Finde mir einen Skill für Kubernetes")
- Wissen möchte, welche Skills für eine Technologie oder einen Bereich verfügbar sind
- Bittet, einen Skill nach Namen oder Thema zu installieren
- Empfehlungen für Skills wünscht, die für sein Projekt relevant sind
- "Skill-Registrierung", "verified-skill.com" oder "vskill" erwähnt
- Fragt "Welche Skills können mir bei X helfen?"
- Gerade vskill installiert hat und erkunden möchte, was verfügbar ist
- Installierte Skills überprüfen, auflisten, aktualisieren oder entfernen möchte
- Detaillierte Informationen zu einem bestimmten Skill vor der Installation anfordert
Schnellstart
Beginne für neue Benutzer oder bei Fragen wie "Was ist verfügbar?" mit folgender Übersicht:
5 Plugin-Bündel sind aus der offiziellen vskill-Sammlung verfügbar und decken die Bereiche mobile, marketing, google-workspace, productivity und discovery (scout) ab.
Jedes Bündel enthält fokussierte, hochwertige Skills. Das
mobile-Bündel umfasst beispielsweise den Skill zur App-Store-Automatisierung.Ein Bündel installieren:
npx vskill install --repo anton-abyzov/vskill --plugin <name> --forceAlles installieren:npx vskill install --repo anton-abyzov/vskill --all --forceRegistrierung durchsuchen:npx vskill find "<Abfrage>"
Arbeitsablauf
Schritt 0: Prüfen, was bereits installiert ist
Bevor du neue Skills empfiehlst, prüfe, was der Benutzer bereits hat:
npx vskill list
Dies zeigt alle installierten Skills mit Versionen und Quellen. Verwende npx vskill list --agents, um zu sehen, welche AI-Agenten auf dem System erkannt werden. Empfehle keine Skills, die bereits installiert sind.
Schritt 1: Die Absicht des Benutzers analysieren
Bestimme, wonach der Benutzer sucht:
- Neuer Benutzer / weiß nicht: Analysiere sein Projekt und empfehle Bündel (siehe Schritt 1b)
- Technologie/Bereich: z. B. "React", "Kubernetes", "Zahlungen", "Testing"
- Bestimmter Skill: z. B. "nextjs", "stripe-integration", "helm-charts"
- Breite Erkundung: z. B. "Was ist verfügbar?", "Zeig mir alles"
- Installierte Skills verwalten: Liste, aktualisiere, entferne oder überprüfe vorhandene Skills
Schritt 1b: Projektbewusste Empfehlungen (wenn der Benutzer nicht weiß)
Wenn der Benutzer sagt "Ich weiß nicht" oder "Was soll ich installieren?", analysiere sein Projekt:
-
Prüfe auf Hinweise zum Tech-Stack:
package.jsonmit React Native/Expo → mobile-Bündelios/oderandroid/-Verzeichnisse → mobile-Bündel- Social-Media- oder Marketing-Kontext → marketing-Bündel
- Google Workspace-Integrationen → google-workspace-Bündel
- Allgemeine Skill-Entdeckung → skills-Bündel (dieser Skill)
-
Basierend auf den Ergebnissen empfehle bestimmte Bündel mit Begründung:
"Basierend auf Ihrem Projekt empfehle ich diese Bündel:
- mobile – Sie haben React Native und Expo in der package.json
- marketing – Sie haben Social-Media-Posting-Bedarf erwähnt"
-
Biete an, alle empfohlenen Bündel auf einmal zu installieren.
Schritt 2: Registrierung durchsuchen
Führe den Suchbefehl über das Terminal aus:
npx vskill find "<Abfrage>" --json
Das --json-Flag liefert strukturierte Ergebnisse. Jedes Ergebnis enthält:
name– Skill-Identifikator (z. B. "mobile:appstore")author– Autor des Skillstier– Zertifizierungsstufe: CERTIFIED oder VERIFIEDscore– Vertrauenswürdigkeits-Score (0-100)installs– Anzahl der Installationendescription– Beschreibung des Skills
Wenn die Suche keine Ergebnisse liefert, versuche:
- Breitere Suchbegriffe (z. B. "react" statt "react server components")
- Verwandte Begriffe (z. B. "frontend" statt "nextjs")
- Empfehle dem Benutzer, https://verified-skill.com direkt zu besuchen
Schritt 3: Ergebnisse präsentieren
Formatiere Suchergebnisse als übersichtliche Tabelle:
| Name | Autor | Stufe | Score | Installationen | Beschreibung |
|-------------------|--------------|------------|-------|----------------|--------------------------------|
| mobile:appstore | Anton Abyzov | CERTIFIED | 95 | 340 | App Store Connect Automatisierung |
| marketing:social | Anton Abyzov | VERIFIED | 88 | 280 | Social-Media-Posting |
Nach der Tabelle:
- Hebe den besten Treffer basierend auf dem Kontext der Benutzeranfrage hervor
- Erkläre, warum er relevant ist (nenne spezifische Fähigkeiten)
- Weise auf Stufenunterschiede hin, wenn Ergebnisse über mehrere Stufen verteilt sind (CERTIFIED > VERIFIED)
Schritt 4: Plugin-Bündel empfehlen
Wenn die Abfrage zu einer bekannten Plugin-Kategorie passt, schlage das vollständige Plugin-Bündel anstelle einzelner Skills vor. Plugin-Bündel installieren mehrere verwandte Skills auf einmal.
Verfügbare Plugin-Bündel (aus anton-abyzov/vskill):
| Plugin | Bereich | Enthaltene Skills |
|---|---|---|
mobile | Mobile Entwicklung | App Store Connect Automatisierung (appstore) |
marketing | Marketing & Kommunikation | Social-Media-Posting, Slack-Nachrichten |
google-workspace | Google Workspace | Google Workspace CLI (gws) |
productivity | Persönliche Produktivität | Experten-Netzwerk-Umfrageabschluss |
skills | Entdeckung | Dieser Skill – durchsuche verified-skill.com und installiere Skills |
Beispiel für eine Empfehlung:
"Ihre Abfrage passt zum mobile-Plugin-Bündel, das den Skill zur App Store Connect Automatisierung enthält. Anstatt einzelne Skills zu installieren, können Sie das gesamte Bündel installieren."
Schritt 5: Installieren
Nachdem der Benutzer ausgewählt hat, was installiert werden soll, führe den entsprechenden Befehl aus:
Einzelnen Skill nach Namen installieren (aus der Registrierung):
npx vskill install <skill-name>
Ein Plugin-Bündel installieren (alle Skills in einem Bereich):
npx vskill install --repo anton-abyzov/vskill --plugin <plugin-name> --force
ALLE Plugin-Bündel auf einmal installieren:
npx vskill install --repo anton-abyzov/vskill --all --force
Das --force-Flag umgeht den interaktiven Sicherheitsscan-Prompt (der Scan wird trotzdem ausgeführt, aber PASS/CONCERNS-Entscheidungen werden automatisch akzeptiert). Dies ist für die offiziellen vskill-Plugins angemessen, die vorab verifiziert wurden.
Aus einem Drittanbieter-GitHub-Repo installieren:
npx vskill install <owner>/<repo>
Einen bestimmten Skill aus einem Repo installieren:
npx vskill install <owner>/<repo> --skill <skill-name>
Erweiterte Installationsflags (bei Bedarf verwenden):
| Flag | Zweck |
|---|---|
--global | In globale Agenten-Verzeichnisse installieren (verfügbar in allen Projekten) |
--select | Interaktiver Auswähler zur Wahl bestimmter Skills und Agenten |
--only-skills <names> | Bestimmte Skills aus einem Plugin auswählen (kommagetrennt) |
--agent <id> | Zielgerichteten AI-Agenten angeben (z. B. claude-code, cursor) |
--copy | Dateikopie statt Symlink erzwingen (nützlich in CI/Containern) |
--yes / -y | Bestätigungsaufforderungen überspringen |
Schritt 5b: Vor der Installation prüfen (Drittanbieter-Skills)
Bei Skills, die NICHT aus der offiziellen anton-abyzov/vskill-Sammlung stammen, immer vor der Installation prüfen:
# Detaillierte Informationen abrufen (Vertrauensstufe, Score, Herkunft, Installationen)
npx vskill info <owner>/<repo>/<skill-name>
# Lokalen Sicherheitsscan einer Skill-Datei durchführen
npx vskill scan <path-to-SKILL.md>
Empfehle --force nur für die offiziellen anton-abyzov/vskill-Plugins. Bei Drittanbieter-Skills lass den Benutzer die Scan-Ergebnisse prüfen und entscheiden.
Schritt 6: Installation bestätigen
Nachdem der Installationsbefehl ausgeführt wurde:
- Melde das Installationsergebnis (Erfolg/Fehlschlag)
- Liste auf, welche Agenten den Skill erhalten haben (Claude Code, Cursor, usw.)
- Nenne den Namensraum des Skills für den Aufruf (z. B.
mobile:appstore) - Schlage einen Neustart des AI-Agenten vor, falls nötig, um neue Skills zu laden
Schritt 7: Installierte Skills verwalten
Hilf Benutzern, ihre installierten Skills auf Anfrage zu verwalten:
Skills aktualisieren (prüft auf neuere Versionen mit Diff-Scan):
npx vskill update <skill-name> # Bestimmten Skill aktualisieren
npx vskill update --all # Alle installierten Skills aktualisieren
Skills entfernen:
npx vskill remove <skill-name> # Aus aktuellem Projekt entfernen
npx vskill remove <skill-name> --global # Aus globaler Installation entfernen
Projekt auf Sicherheitsprobleme prüfen:
npx vskill audit # Vollständiges Projekt-Audit
npx vskill audit --ci # CI-freundliche Ausgabe (beendet mit Fehlercode bei Problemen)
Fehlerbehandlung
| Szenario | Aktion |
|---|---|
npx vskill nicht gefunden | Sag dem Benutzer, er soll installieren: npm install -g vskill oder npx verwenden |
npm error code E401 mit npx | Eine projektbezogene .npmrc mit einer privaten Registry stört. Verwende: npx --registry https://registry.npmjs.org vskill <Befehl> oder global installieren: npm i -g vskill --registry https://registry.npmjs.org |
| Netzwerkfehler bei der Suche | Schlage vor, die Internetverbindung zu prüfen; biete an, es erneut zu versuchen |
| Keine Ergebnisse gefunden | Versuche breitere Suchbegriffe; schlage vor, verified-skill.com direkt zu besuchen |
| Scan FAIL bei Installation | Erkläre das Sicherheitsproblem; empfehle zuerst npx vskill scan, um Details zu prüfen; schlage --force nur vor, wenn der Benutzer das Risiko versteht |
| Scan CONCERNS bei Installation | Erkläre die Ergebnisse; --force ist hier sicherer als bei FAIL |
| Blockierter Skill (Blocklist) | Warne den Benutzer nachdrücklich; dieser Skill hat bekannte Sicherheitsprobleme |
| Keine Agenten erkannt | Der Benutzer muss zuerst Claude Code, Cursor oder einen anderen unterstützten Agenten installieren |
| Ratenlimit (HTTP 429 oder GitHub 403) | Warte eine Minute und wiederhole; schlage vor, --json zu verwenden, um API-Aufrufe zu reduzieren |
| Teilweiser Installationsfehler | Einige Skills in einem Bündel können fehlschlagen (Berechtigungen, Symlinks). Prüfe mit npx vskill list, was erfolgreich war; wiederhole einzelne Fehlschläge |
| Lock-Datei nicht synchron | Führe npx vskill init aus, um die Lock-Datei mit den tatsächlich installierten Skills zu resynchronisieren |
| Bereits installiert (Versionskonflikt) | Führe npx vskill update <skill> zum Aktualisieren aus oder npx vskill remove und dann erneut installieren |
Beispiele
Beispiel 1: Einführung neuer Benutzer
Benutzer: "Ich habe gerade vskill installiert. Was soll ich installieren?" Aktion:
- Prüfe den Tech-Stack des Projekts (package.json, go.mod, usw.)
- Präsentiere projektbewusste Bündelempfehlungen
- Biete
--allan, um alles zu installieren, oder lass sie bestimmte Bündel auswählen - Installiere ihre Auswahl
Beispiel 2: Technologie-Suche
Benutzer: "Ich brauche Hilfe bei Kubernetes-Bereitstellungen" Aktion:
- Führe
npx vskill find "kubernetes" --jsonaus - Präsentiere Ergebnistabelle
- Empfehle relevante Skills aus der Registrierung
- Frage, ob sie einzelne Skills oder ein vollständiges Bündel möchten
- Installiere ihre Wahl
Beispiel 3: Installation eines bestimmten Skills
Benutzer: "Installiere den Next.js-Skill" Aktion:
- Führe
npx vskill find "nextjs" --jsonaus, um die Verfügbarkeit zu bestätigen - Zeige das Ergebnis mit Stufe und Score
- Führe
npx vskill install <owner>/<repo> --skill <skill-name>mit dem tatsächlichen Suchergebnis aus - Bestätige, welche Agenten den Skill erhalten haben
Beispiel 4: Breite Erkundung
Benutzer: "Welche Skills sind verfügbar?" Aktion:
- Liste die 5 verfügbaren Plugin-Bündel mit Beschreibungen auf
- Frage, welcher Bereich sie interessiert
- Durchsuche diesen Bereich und präsentiere spezifische Skills
- Installiere basierend auf der Auswahl
Beispiel 5: Projektbewusste Empfehlung
Benutzer: "Welche Skills würden bei meinem Projekt helfen?" Aktion:
- Führe
npx vskill listaus, um zu prüfen, was bereits installiert ist - Prüfe den Tech-Stack des Projekts (package.json, Cargo.toml, go.mod, usw.)
- Identifiziere relevante Bereiche (mobile, marketing, google-workspace, productivity)
- Suche nach Skills, die zu jedem Bereich passen
- Präsentiere eine kuratierte Empfehlungsliste (ausschließlich bereits installierter Skills)
- Biete an, passende Bündel zu installieren
Beispiel 6: Installierte Skills verwalten
Benutzer: "Aktualisiere alle meine Skills" / "Entferne den appstore-Skill" Aktion:
- Für Aktualisierungen: führe
npx vskill update --allaus und berichte, was sich geändert hat - Für Entfernung: führe
npx vskill remove <skill-name>aus und bestätige - Für Überprüfung: führe
npx vskill info <skill-name>aus, um Details anzuzeigen
Beispiel 7: Vor der Installation prüfen
Benutzer: "Ist dieser Kubernetes-Skill sicher zu installieren?" Aktion:
- Führe
npx vskill info <owner>/<repo>/<skill-name>aus, um Stufe und Score zu prüfen - Präsentiere die Vertrauensstufe, den Sicherheits-Score, die Herkunft und die Installationsanzahl
- Erkläre, was die Stufe bedeutet (siehe Abschnitt Vertrauensstufen)
- Wenn VERIFIED oder CERTIFIED, bestätige die Sicherheit; wenn UNSCANNED, schlage vor, zuerst
npx vskill scanauszuführen
Vertrauensstufen
Erkläre bei der Präsentation von Ergebnissen die Vertrauensstufen, um Benutzern fundierte Entscheidungen zu ermöglichen:
- CERTIFIED – Höchstes Vertrauen. Manuell überprüft und vom Plattform-Team zertifiziert. Sicher zu installieren.
- VERIFIED – Grundlegendes Vertrauen und höher. Automatisierte Scans bestanden, Autorenidentität verifiziert. Sicher zu installieren.
- UNSCANNED – Keine Scan-Daten. Verwende
--forcezur Installation, aber prüfe zuerst den Skill-Inhalt. - BLOCKED – Bekannt bösartig. NICHT installieren, es sei denn, du hast einen sehr spezifischen Grund und verstehst die Risiken.
Wichtige Hinweise
- Verwende immer das
--json-Flag bei programmatischer Suche, um strukturierte Ausgabe zu erhalten - Das
--force-Flag bei der Installation umgeht Scan-Prompts, überspringt aber NICHT den Scan selbst - Verwende
--forcenur für offizielleanton-abyzov/vskill-Plugins – bei Drittanbieter-Skills führe zuerstnpx vskill infoaus und prüfe die Scan-Ergebnisse - Plugin-Bündel von
anton-abyzov/vskillsind die offizielle kuratierte Sammlung - Drittanbieter-Skills sollten anhand ihrer Vertrauensstufe und ihres Scores bewertet werden – verwende
npx vskill info <skill>, um zu prüfen - Skills werden pro Agent installiert (Claude Code, Cursor, usw.) – die CLI unterstützt Multi-Agent-Installationen
- Verwende
--allmit--repo, um alle 5 Plugin-Bündel in einem Befehl zu installieren - Führe vor der Empfehlung
npx vskill listaus, um die Empfehlung bereits installierter Skills zu vermeiden vskill searchist ein Alias fürvskill find– beide funktionieren identisch