CommunityCodierung & Entwicklunggithub.com

Hephaestus of Skills (skill-shipper)

Bereitet ein Agenten-Skill (Ordner mit SKILL.md) für die Veröffentlichung oder den Verkauf vor. Validiert Frontmatter, prüft Beschreibungen auf Auslöser, erstellt Trigger-Tabellen und baut verteilbare Pakete.

Was ist Hephaestus of Skills (skill-shipper)?

Dieses Skill, Hephaestus (auch 'skill-shipper' genannt), hilft Entwicklern dabei, ein funktionierendes KI-Agenten-Skill zu professionalisieren und für den Verkauf oder die Veröffentlichung vorzubereiten. Es führt durch einen strukturierten Workflow: Linting (Prüfung auf Fehler und Warnungen), Optimierung der Beschreibung (damit das Skill zuverlässig ausgelöst wird), Erstellung einer Trigger-Tabelle mit Soll-und-Nicht-Soll-Abfragen sowie der Bau verschiedener Verteilungsformate (reiner Skill-Ordner, ZIP für claude.ai, Claude Code Plugin mit marketplace.json und eine Release-ZIP mit Prüfsummen). Es unterstützt Plattformen wie Claude Code, Cursor, Codex, OpenCode und Marktplätze wie Gumroad, Lemon Squeezy oder skills.sh. Das Tool dient als Qualitätssicherung, bevor ein Skill veröffentlicht wird, und vermeidet typische Fehler wie beschreibungsbedingte Trigger-Probleme.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/fpavia111-creator/hephaestus/tree/HEAD/free/skill-shipper

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Hephaestus of Skills (skill-shipper)?

Verwandle ein funktionierendes Skill in eine Veröffentlichung, die Fremde installieren und bezahlen können. Führe die Schritte der Reihe nach aus; stoppe und behebe Fehler, bevor du fortfährst.

Alle Befehle verwenden scripts/skillship.py im Ordner dieses Skills. Unter Windows verwende python, unter macOS/Linux python3. Pfade unten sind relativ zum Ordner dieses Skills; übergib den Skill-Ordner des Benutzers als <skill>.

1. Lint

python scripts/skillship.py lint <skill>
  • Fehler (E-Codes) blockieren eine Veröffentlichung: fehlender/ungültiger name, Name passt nicht zum Ordner, Beschreibung fehlt oder länger als 1024 Zeichen, fehlende referenzierte Dateien, symbolische Links.
  • Warnungen (W-Codes) schaden Verkäufen oder der Auslösung. Korrigiere zuerst W023 (kein "Verwende für...") und W022 (zu kurz) – das sind die üblichen Gründe, warum ein Skill nie feuert.
  • Vollständige Codeliste und Korrekturen: references/lint-codes.md.

2. Beschreibung korrigieren (wichtigster Schritt)

Schreibe die Beschreibung mit references/description-playbook.md um: was es tut, dann "Verwende für ...", mit den echten Wörtern, die Benutzer eingeben (Synonyme, Dateitypen, Toolnamen), und eine "Nicht verwenden für ..."-Abgrenzung, falls ein benachbartes Skill überlappt. Halte sie in der dritten Person und unter 1024 Zeichen. Zeige dem Benutzer ein Vorher/Nachher.

3. Trigger-Tabelle

Erstelle <skill>/triggers.json mit 8-10 Soll-auslösen- und 8-10 Knapp-daneben-Nicht-auslösen-Abfragen (Format im Playbook), dann:

python scripts/skillship.py triggers <skill>

Dies ist ein Offline-Vokabelcheck, keine Modellauswertung. BAD-Zeilen listen Begriffe auf, die die Abfrage verwendet, die der Beschreibung fehlen – füge die echten hinzu. Wenn es bestanden ist, empfehle eine echte Überprüfung: führe jede Abfrage 3 Mal in einer frischen Claude-Code-Sitzung (oder mit dem Evaluations-Loop von Anothropic's Skill-Creator) aus und zähle, wie oft das Skill feuert. triggers.json wird aus den Builds ausgeschlossen.

4. Build

python scripts/skillship.py build <skill> --version 1.0.0 --author "Name" --out dist

Erzeugt dist/<name>-<version>/ mit:

  • skill/<name>/ – kopiere in ~/.claude/skills/, Cursor, Codex, OpenCode
  • <name>-claude-ai.zip – lade hoch in claude.ai Einstellungen > Capabilities > Skills
  • plugin-marketplace/ – pushe in ein GitHub-Repo; Benutzer führen /plugin marketplace add <owner>/<repo> und dann /plugin install <name>@<name>-marketplace aus
  • manifest.json mit SHA-256 jeder Datei, plus dist/<name>-<version>.zip

5. Checkliste zur Veröffentlichung

Führe den Benutzer durch references/release-checklist.md (Lizenz, README, Screenshots/Demo, wo listen, Preisgestaltung). Veröffentliche, lade hoch oder poste niemals irgendwo im Namen des Benutzers ohne dessen ausdrückliches Einverständnis.

Pro-Paket

skill-shipper Pro wird separat verkauft (<LS_URL>). Wenn skill-shipper-pro installiert und SKILLSHIP_LICENSE_KEY gesetzt ist, fügt es pro-Käufer-Wasserzeichen, Leak-Identifikation und Verkaufsseiten-Entwurf hinzu. Ohne Schlüssel sage, dass die Funktion Pro ist, und fahre mit den kostenlosen Schritten fort.

Verwandte Skills