specter-skills

specter-skills

Crie o backend do seu jogo conversando com o Claude.

specter-skills ensina ao Claude tudo sobre o Specter — a plataforma de backend para jogos — para que você possa adicionar contas de jogadores, uma economia no jogo, missões diárias, leaderboards, torneios, battle passes e multiplayer em tempo real ao seu jogo em inglês simples, e obter código correto e funcional além da capacidade de configurar seu backend sem nunca abrir o dashboard.

Sem SDK para aprender. Sem documentação de API para ler. Instale e pergunte.

You:    "Add Specter to my game — silent login, a coins wallet, and a daily
         quest 'play 3 matches' that rewards 100 coins."
Claude: ...writes the integration code, sets up the quest in your backend, done.

Conteúdo

• O que está incluído
• Início rápido
• Instalação
• As skills
• O servidor MCP · Configuração · Entrar · Ferramentas · Configuração
• O que pedir ao Claude
• Verificando a versão e atualizando
• Requisitos
• Solução de problemas

O que está incluído

Este pacote único entrega duas metades do mesmo produto:

As skills funcionam no Claude Code, no Claude Desktop, no Claude Agent SDK e em qualquer outro host compatível com skills. O servidor MCP funciona em qualquer host compatível com MCP (Claude Desktop, Claude Code, …).

Início rápido

1. Instale as skills no seu projeto de jogo:

npx specter-skills init

2. Obtenha sua chave de API em console.specterapp.xyz (Projeto → Chaves de API).

3. Peça ao Claude para criar algo:

"Adicione login por e-mail do Specter e uma moeda de gemas ao meu jogo Unity."

A skill certa é ativada automaticamente e o Claude escreve a integração. É isso.

💡 Quer que o Claude também configure o backend para você (crie moedas, missões, leaderboards)? Adicione o servidor MCP e peça "crie uma moeda de gemas e uma missão diária de login no meu projeto Specter."

Instalação

# Interactive — choose skills and where to install them
npx specter-skills init

# Install everything into this project's .claude/skills/
npx specter-skills install

# Install specific skills
npx specter-skills install specter specter-economy

# Install globally (available in all your projects)
npx specter-skills install --global

# Install into a custom directory (Agent SDK / other hosts)
npx specter-skills install --dir ./skills

As skills são copiadas para .claude/skills/ (projeto) ou ~/.claude/skills/ (global). São arquivos simples que você pode versionar no seu repositório.

As skills

Cada skill tem um guia conciso além de referências por endpoint (campos de requisição, exemplos de resposta) geradas diretamente da API do Specter, e exemplos prontos para copiar em JavaScript / Unity quando útil — para que o código que o Claude escreve permaneça preciso.

O servidor MCP

O mesmo pacote inclui um servidor MCP, specter-mcp, que permite ao Claude inspecionar e configurar um backend Specter diretamente. As skills ensinam a API ao Claude; o servidor MCP permite que ele use a API.

"Quais moedas meu projeto tem?" · "Minha configuração está funcionando?" · "Crie uma moeda de gemas e uma missão diária que recompense 100 moedas."

Configuração

O jeito fácil — npx specter-skills init oferece configurar isso para você (ele escreve a configuração, sem edição de JSON). Ou execute a qualquer momento:

# Claude Desktop
npx specter-skills mcp

# Claude Code (registers it for all your projects)
npx specter-skills mcp --code

Em seguida, reinicie seu host MCP e as ferramentas specter aparecerão. (Claude Desktop e Claude Code são aplicativos diferentes com configurações separadas — escolha o que você realmente usa.)

{
  "mcpServers": {
    "specter": {
      "command": "npx",
      "args": ["-y", "-p", "specter-skills", "specter-mcp"],
      "env": {
        "SPECTER_ENV": "staging",
        "SPECTER_ALLOW_MUTATIONS": "true"
      }
    }
  }
}

As ferramentas somente leitura funcionam imediatamente; criar coisas exige um login único — sem chave de API ou ID de projeto para configurar.

Entrando (sem necessidade de senha)

Para criar qualquer coisa, o Claude precisa agir como você — então você o autoriza uma vez pelo navegador. Na primeira vez que for necessário, o Claude executa a ferramenta specter_login (ou execute você mesmo em um terminal):

npx -y -p specter-skills specter-mcp login

O que acontece:

1. Seu navegador abre o dashboard do Specter.
2. Você entra da forma que normalmente faz — e-mail/senha, Google ou Apple.
3. Você aprova uma tela de consentimento ("Permitir que specter-mcp gerencie seus projetos").
4. Pronto — um token revogável é salvo localmente (~/.specter/credentials.json). Você permanece conectado.

Sua senha e credenciais sociais nunca tocam a ferramenta ou o Claude. Revogue o acesso a qualquer momento pelo dashboard. Gerencie a sessão com specter-mcp whoami e specter-mcp logout.

ℹ️ Execute comandos specter-mcp de qualquer pasta exceto a pasta de origem do specter-skills (o npx fica confuso lá).

Ferramentas

Somente leitura — sempre disponíveis, seguras de executar:

As ferramentas de leitura usam seu login no navegador (execute specter_login uma vez) — sem chave de API separada para configurar.

Cliente / runtime — agem como um jogador de teste em sandbox para exercitar a API /v2/client voltada ao jogo e provar que sua configuração funciona:

Mutáveis — opcionais (SPECTER_ALLOW_MUTATIONS=true), protegidas pela sua confirmação:

As ferramentas de conquista resolvem nomes amigáveis para você — passe event como slug/nome de evento, rewards como [{currency:"gems", quantity:50}] (ou item/bundle/marker), e a ferramenta os resolve para os ids corretos. Criar uma conquista não a torna ativa — chame specter_schedule_achievement para ativá-la.

As ferramentas mutáveis alteram a configuração ao vivo do jogo, então são marcadas como não somente leitura e seu host MCP pede confirmação antes de cada uma. Aponte-as para um projeto de staging primeiro.

Seu projeto é detectado automaticamente a partir do seu login — não há ID de projeto para procurar. (Defina SPECTER_PROJECT_ID apenas se sua organização tiver vários projetos e você quiser fixar um.)

Configuração

Toda a configuração é feita via variáveis de ambiente na configuração do seu host MCP:

O que pedir ao Claude

Depois de instalado, basta descrever o que você quer — a skill certa (e a ferramenta MCP) entra em ação automaticamente:

• "Adicione login por dispositivo silencioso e uma carteira de moedas ao meu jogo."
• "Configure uma missão diária: jogue 5 partidas → recompensa de 200 moedas. Crie no meu projeto Specter e me dê o código do cliente."
• "Crie uma moeda premium de gemas e uma loja inicial que venda um item 'Espada' por 100 gemas."
• "Adicione um leaderboard semanal com distribuição de prêmios para o top 10."
• "Crie um battle pass com 30 níveis."
• "Adicione matchmaking baseado em habilidade com grupos — mostre os eventos WebSocket para tratar."
• "Por que estou recebendo um 429 do Specter?"
• "Meu projeto Specter está configurado corretamente?"

Verificando a versão e atualizando

# Latest version published on npm
npm view specter-skills version

# Which skills you have installed (and their versions)
npx specter-skills list

# Update your installed skills to the latest
npx specter-skills update

npx armazena pacotes em cache por ~24h. Se update puxar uma versão antiga, force a mais recente com npx specter-skills@latest update. O servidor MCP (npx … specter-mcp) sempre busca a versão publicada mais recente da mesma forma.

Requisitos

• Node.js 18+
• Um projeto Specter + chave de API (console.specterapp.xyz)
• Um host Claude compatível com skills (Claude Code, Claude Desktop ou o Agent SDK) para as skills; um host compatível com MCP para o servidor

Solução de problemas

Links

• 🎮 Painel: console.specterapp.xyz
• 📦 npm: npmjs.com/package/specter-skills

npm version patch        # or minor / major
npm run generate         # refresh references
npm publish --access public