claude-skill

Esta página fornece uma skill do Claude Code para download que automatiza a instalação do Spck CLI (spck) como um serviço systemd no Linux. Com a skill instalada, você pode pedir ao Claude Code para "executar o spck como um serviço" e ele verificará seu ambiente, gerará um arquivo de unidade correto com seus caminhos absolutos, instalará e verificará se está em execução — sem precisar copiar e colar comandos de uma lista.

A skill codifica a mesma configuração do systemd descrita em Usando Tmux → Alternativa: Serviço Linux, mais as verificações prévias e os diagnósticos de falha que são fáceis de perder ao escrever o arquivo de unidade manualmente.

Download

Baixe o arquivo de skill e salve no diretório de skills local do Claude Code:

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

Ou baixe manualmente: SKILL.md — coloque em ~/.claude/skills/spck-cli-service/SKILL.md.

O que a Skill Faz

Quando invocada, a skill guia o Claude Code por toda a instalação:

1. Verifica se o host é Linux com systemd em execução.
2. Resolve o caminho absoluto para spck (evita a incompatibilidade de PATH que quebra o ExecStart).
3. Avisa se node foi instalado via nvm — esses caminhos mudam a cada atualização do Node e quebram a unidade silenciosamente.
4. Confirma que ~/.spck-editor/.credentials.json existe (a CLI deve ter sido executada de forma interativa pelo menos uma vez antes de funcionar como serviço).
5. Escolhe entre um serviço de usuário (systemctl --user, sem sudo) e um serviço de sistema com base nas suas necessidades.
6. Escreve o arquivo de unidade com seus caminhos reais preenchidos — sem marcadores de posição.
7. Executa daemon-reload, enable --now, e então acompanha o journal para confirmar que a CLI se conectou ao servidor relay.

A skill também documenta os sete modos de falha mais comuns (caminho ExecStart errado, credenciais ausentes, erros de permissão no diretório do projeto, loops de reinicialização atingindo start-limit-hit, caminhos nvm obsoletos após atualização do npm, etc.) para que o Claude Code possa diagnosticar um serviço quebrado em vez de simplesmente regenerar o arquivo de unidade.

Instalação

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

Uso

Uma vez instalada, invoque a skill pedindo ao Claude Code em linguagem natural. Exemplos que a ativarão:

• "Instale o spck como um serviço systemd"
• "Faça o Spck CLI iniciar no boot"
• "Meu spck-cli.service fica reiniciando, você consegue depurar?"
• "Execute o spck como um daemon para que sobreviva à minha desconexão SSH"

O Claude Code lerá a skill, executará as verificações prévias (que solicitarão aprovação de cada comando) e então gerará e instalará o arquivo de unidade. Revise cada comando antes de aprovar — especialmente os que escrevem em /etc/systemd/system/ com sudo.

O que é Instalado

A skill instala um único arquivo de unidade. Para um serviço de usuário:

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

Com conteúdo como:

[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

Para um serviço de sistema, o arquivo fica em /etc/systemd/system/spck-cli.service e adiciona as diretivas User= e Group=. A skill escolhe a variante correta com base no seu ambiente e escreve os caminhos absolutos reais no arquivo.

Por que uma Skill em vez de Copiar e Colar?

O arquivo de unidade na documentação do tmux é um ponto de partida, mas várias coisas precisam estar corretas para o serviço realmente funcionar:

• ExecStart deve ser o caminho absoluto para spck. which spck dentro de um shell de login resolverá manipulações de PATH do .bashrc que o systemd não vê.
• Se spck foi instalado sob nvm, o caminho incorpora a versão do Node — atualizar o Node quebra o serviço silenciosamente até o próximo reboot.
• A CLI deve ter sido executada de forma interativa pelo menos uma vez para criar ~/.spck-editor/.credentials.json. Uma nova inicialização do serviço sem credenciais termina de forma limpa sem nenhum erro óbvio.
• User= deve ser o proprietário do WorkingDirectory, caso contrário o monitoramento de arquivos encontra EACCES e a CLI entra em loop de reinicialização.
• Serviços de usuário precisam de loginctl enable-linger em servidores sem monitor, caso contrário só executam enquanto uma sessão de login está ativa.

A skill codifica tudo isso para que você não precise lembrar.

Desinstalar

Desativar e remover o serviço:

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

Para um serviço de sistema:

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

Para remover a skill do Claude Code:

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

Veja Também

• Agentes de IA no Mobile (ACP) — uma vez que a CLI está rodando como serviço, isso é o que desbloqueia o controle do Claude Code (e Codex / Gemini) a partir do seu celular, com a cobrança feita através da sua própria assinatura Anthropic em vez da sua cota Spck Editor.
• Usando Tmux — abordagem alternativa usando tmux para manter a CLI ativa durante desconexões SSH.
• Uso Avançado — referência completa de comandos CLI, substituições de configuração e configurações multi-projeto.
• Configuração — configurações de terminal, sistema de arquivos, segurança e autenticação que o arquivo de unidade não cobre.