claude-skill

Diese Seite stellt eine herunterladbare Claude Code-Skill bereit, die die Installation von Spck CLI (spck) als systemd-Dienst unter Linux automatisiert. Mit installierter Skill kannst du Claude Code bitten, „spck als Dienst auszuführen", und Claude Code prüft dann deine Umgebung, generiert eine korrekte Unit-Datei mit deinen absoluten Pfaden, installiert sie und verifiziert, dass sie läuft — ohne manuelles Kopieren von Befehlen aus einer Checkliste.

Die Skill kodiert dasselbe systemd-Setup wie unter Tmux verwenden → Alternative: Linux-Dienst beschrieben, plus die Vorab-Prüfungen und Fehlerdiagnosen, die beim manuellen Schreiben der Unit-Datei leicht übersehen werden.

Herunterladen

Lade die Skill-Datei herunter und speichere sie im lokalen Claude Code-Skills-Verzeichnis:

mkdir -p ~/.claude/skills/spck-cli-service
curl -fsSL https://docs.spck.io/assets/skills/spck-cli-service/SKILL.md \
  -o ~/.claude/skills/spck-cli-service/SKILL.md

Oder manuell herunterladen: SKILL.md — unter ~/.claude/skills/spck-cli-service/SKILL.md ablegen.

Was die Skill tut

Bei Aufruf führt die Skill Claude Code durch die vollständige Installation:

1. Prüft, ob der Host Linux mit systemd ist.
2. Ermittelt den absoluten Pfad zu spck (vermeidet den PATH-Konflikt, der ExecStart zum Scheitern bringt).
3. Warnt, wenn node via nvm installiert ist — diese Pfade ändern sich bei jedem Node-Upgrade und machen den Dienst lautlos kaputt.
4. Bestätigt, dass ~/.spck-editor/.credentials.json vorhanden ist (die CLI muss mindestens einmal interaktiv ausgeführt worden sein, bevor sie als Dienst läuft).
5. Wählt zwischen einem Benutzerdienst (systemctl --user, kein sudo) und einem Systemdienst je nach Bedarf.
6. Schreibt die Unit-Datei mit deinen echten Pfaden ausgefüllt — keine Platzhalter.
7. Führt daemon-reload, enable --now aus und verfolgt anschließend das Journal, um zu bestätigen, dass die CLI mit dem Relay-Server verbunden ist.

Die Skill dokumentiert außerdem die sieben häufigsten Fehlermodi (falscher ExecStart-Pfad, fehlende Credentials, Berechtigungsfehler im Projektverzeichnis, Restart-Loops mit start-limit-hit, veraltete nvm-Pfade nach npm-Upgrade usw.), sodass Claude Code einen defekten Dienst diagnostizieren kann, anstatt die Unit-Datei einfach neu zu generieren.

Installation

mkdir -p ~/.claude/skills/spck-cli-service
curl -fsSL https://docs.spck.io/assets/skills/spck-cli-service/SKILL.md \
  -o ~/.claude/skills/spck-cli-service/SKILL.md

claude /skills

Verwendung

Nach der Installation kannst du die Skill aufrufen, indem du Claude Code in normaler Sprache bittest. Beispiele, die sie auslösen:

• „Installiere spck als systemd-Dienst"
• „Lass Spck CLI beim Systemstart starten"
• „Mein spck-cli.service startet ständig neu, kannst du das debuggen?"
• „Führe spck als Daemon aus, damit es meine SSH-Trennung überlebt"

Claude Code liest die Skill, führt die Vorab-Prüfungen durch (du wirst gebeten, jeden Befehl zu genehmigen) und generiert und installiert dann die Unit-Datei. Überprüfe jeden Befehl vor der Genehmigung — insbesondere jene, die unter sudo in /etc/systemd/system/ schreiben.

Was installiert wird

Die Skill installiert eine einzelne Unit-Datei. Bei einem Benutzerdienst lautet der Pfad:

~/.config/systemd/user/spck-cli.service

Mit folgendem Inhalt:

[Unit]
Description=Spck CLI Server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/your-project
ExecStart=/usr/local/bin/spck
Restart=on-failure
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5

[Install]
WantedBy=default.target

Bei einem Systemdienst liegt die Datei unter /etc/systemd/system/spck-cli.service und enthält zusätzliche User=- und Group=-Direktiven. Die Skill wählt die richtige Variante basierend auf deiner Umgebung und trägt die tatsächlichen absoluten Pfade in die Datei ein.

Warum eine Skill statt Copy-Paste?

Die Unit-Datei in der tmux-Dokumentation ist ein Ausgangspunkt, aber mehrere Dinge müssen korrekt sein, damit der Dienst tatsächlich funktioniert:

• ExecStart muss der absolute Pfad zu spck sein. which spck innerhalb einer Login-Shell löst PATH-Manipulationen aus .bashrc auf, die systemd nicht sieht.
• Wenn spck unter nvm installiert wurde, enthält der Pfad die Node-Version — ein Node-Upgrade macht den Dienst lautlos kaputt bis zum nächsten Neustart.
• Die CLI muss mindestens einmal interaktiv ausgeführt worden sein, um ~/.spck-editor/.credentials.json zu erstellen. Ein frischer Dienststart ohne Credentials endet sauber ohne offensichtliche Fehlermeldung.
• User= muss das WorkingDirectory besitzen, sonst trifft die Dateiüberwachung auf EACCES und die CLI startet in einer Schleife neu.
• Benutzerdienste benötigen loginctl enable-linger auf kopflosen Servern, sonst laufen sie nur während einer aktiven Login-Sitzung.

Die Skill kodiert all das, damit du es dir nicht merken musst.

Deinstallation

Dienst deaktivieren und entfernen:

systemctl --user disable --now spck-cli
rm ~/.config/systemd/user/spck-cli.service
systemctl --user daemon-reload

Für einen Systemdienst:

sudo systemctl disable --now spck-cli
sudo rm /etc/systemd/system/spck-cli.service
sudo systemctl daemon-reload

Um die Skill selbst aus Claude Code zu entfernen:

rm -rf ~/.claude/skills/spck-cli-service

Siehe auch

• KI-Coding-Agenten auf dem Handy (ACP) — sobald die CLI als Dienst läuft, wird damit das Steuern von Claude Code (sowie Codex / Gemini) vom Handy aus freigeschaltet, wobei die Abrechnung über Ihr eigenes Anthropic-Abonnement statt über Ihr Spck Editor-Kontingent erfolgt.
• Tmux verwenden — alternativer Ansatz mit tmux, um die CLI bei SSH-Trennungen am Laufen zu halten.
• Erweiterte Nutzung — vollständige CLI-Befehlsreferenz, Konfigurationsüberschreibungen und Multi-Projekt-Setups.
• Konfiguration — Terminal-, Dateisystem-, Sicherheits- und Authentifizierungseinstellungen, die die Unit-Datei nicht abdeckt.