specter-skills

specter-skills

Construye el backend de tu juego hablando con Claude.

specter-skills le enseña a Claude todo sobre Specter — la plataforma de backend para juegos — para que puedas añadir cuentas de jugador, una economía dentro del juego, misiones diarias, tablas de clasificación, torneos, pases de batalla y multijugador en tiempo real a tu juego en inglés sencillo, y obtener código correcto y funcional además de la capacidad de configurar tu backend sin siquiera abrir el panel de control.

No hay SDK que aprender. No hay documentación de API que leer. Instálalo y luego pregunta.

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.

Contenido

• Qué incluye
• Inicio rápido
• Instalación
• Las habilidades
• El servidor MCP · Configuración · Iniciar sesión · Herramientas · Configuración
• Cosas que puedes pedirle a Claude
• Comprobar la versión y actualizar
• Requisitos
• Solución de problemas

Qué incluye

Este paquete incluye dos mitades del mismo producto:

Las habilidades funcionan en Claude Code, Claude Desktop, el Claude Agent SDK y cualquier otro host compatible con habilidades. El servidor MCP funciona en cualquier host compatible con MCP (Claude Desktop, Claude Code, …).

Inicio rápido

1. Instala las habilidades en tu proyecto de juego:

npx specter-skills init

2. Obtén tu clave de API desde console.specterapp.xyz (Proyecto → Claves de API).

3. Pídele a Claude que construya algo:

"Añade inicio de sesión con email de Specter y una moneda de gemas a mi juego de Unity."

La habilidad correcta se activa automáticamente y Claude escribe la integración. Eso es todo.

💡 ¿Quieres que Claude también configure el backend por ti (crear monedas, misiones, tablas de clasificación)? Añade el servidor MCP y pide "crea una moneda de gemas y una misión diaria de inicio de sesión en mi proyecto de Specter."

Instalación

# 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

Las habilidades se copian en .claude/skills/ (proyecto) o ~/.claude/skills/ (global). Son archivos simples que puedes confirmar en tu repositorio.

Las habilidades

Cada habilidad tiene una guía concisa además de referencias por endpoint (campos de solicitud, ejemplos de respuesta) generadas directamente desde la API de Specter, y ejemplos listos para pegar de JavaScript / Unity cuando sea útil — para que el código que escribe Claude sea preciso.

El servidor MCP

El mismo paquete incluye un servidor MCP, specter-mcp, que permite a Claude inspeccionar y configurar un backend de Specter directamente. Las habilidades enseñan a Claude la API; el servidor MCP le permite usar la API.

"¿Qué monedas tiene mi proyecto?" · "¿Mi configuración está funcionando?" · "Crea una moneda de gemas y una misión diaria que recompense 100 monedas."

Configuración

La forma fácil — npx specter-skills init ofrece configurar esto por ti (escribe la configuración, sin editar JSON). O ejecútalo en cualquier momento:

# Claude Desktop
npx specter-skills mcp

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

Luego reinicia tu host MCP y aparecerán las herramientas de specter. (Claude Desktop y Claude Code son aplicaciones diferentes con configuraciones separadas — elige la que realmente uses).

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

Las herramientas de solo lectura funcionan de inmediato; crear cosas requiere un inicio de sesión único — sin clave de API ni ID de proyecto que configurar.

Iniciar sesión (sin necesidad de contraseña)

Para crear cualquier cosa, Claude necesita actuar como tú — así que lo autorizas una vez a través de tu navegador. La primera vez que se necesite, Claude ejecuta la herramienta specter_login (o ejecútala tú mismo en una terminal):

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

Qué sucede:

1. Tu navegador abre el panel de control de Specter.
2. Inicias sesión como lo haces normalmente — email/contraseña, Google o Apple.
3. Apruebas una pantalla de consentimiento ("Permitir que specter-mcp gestione tus proyectos").
4. Listo — se guarda un token revocable localmente (~/.specter/credentials.json). Permaneces con la sesión iniciada.

Tu contraseña y credenciales sociales nunca tocan la herramienta ni a Claude. Revoca el acceso en cualquier momento desde el panel de control. Gestiona la sesión con specter-mcp whoami y specter-mcp logout.

ℹ️ Ejecuta los comandos de specter-mcp desde cualquier carpeta excepto la carpeta fuente de specter-skills (npx se confunde allí).

Herramientas

Solo lectura — siempre disponibles, seguras de ejecutar:

Las herramientas de lectura usan tu inicio de sesión del navegador (ejecuta specter_login una vez) — sin clave de API separada que configurar.

Cliente / tiempo de ejecución — actúan como un jugador de prueba en entorno aislado para ejercitar la API /v2/client orientada al juego y demostrar que tu configuración funciona:

Mutación — opcional (SPECTER_ALLOW_MUTATIONS=true), protegida detrás de tu confirmación:

Las herramientas de logros resuelven nombres amigables por ti — pasa event como slug/nombre de evento, rewards como [{currency:"gems", quantity:50}] (o item/bundle/marker), y la herramienta los resuelve a los ids correctos. Crear un logro no lo hace activo — llama a specter_schedule_achievement para activarlo.

Las herramientas de mutación cambian la configuración del juego en vivo, por lo que están marcadas como no solo lectura y tu host MCP pide confirmación antes de cada una. Apúntalas a un proyecto de prueba primero.

Tu proyecto se detecta automáticamente desde tu inicio de sesión — no hay ID de proyecto que buscar. (Solo establece SPECTER_PROJECT_ID si tu organización tiene varios proyectos y quieres fijar uno.)

Configuración

Toda la configuración es mediante variables de entorno en la configuración de tu host MCP:

Cosas que puedes pedirle a Claude

Una vez instalado, solo describe lo que quieres — la habilidad correcta (y la herramienta MCP) se activa automáticamente:

• "Añade inicio de sesión silencioso de dispositivo y una cartera de monedas a mi juego."
• "Configura una misión diaria: jugar 5 partidas → recompensa 200 monedas. Créala en mi proyecto de Specter y dame el código de cliente."
• "Crea una moneda de gemas premium y una tienda inicial que venda un objeto 'Espada' por 100 gemas."
• "Añade una tabla de clasificación semanal con distribución de premios para los 10 primeros."
• "Construye un pase de batalla con 30 niveles."
• "Añade emparejamiento basado en habilidades con grupos — muéstrame los eventos de WebSocket que debo manejar."
• "¿Por qué recibo un 429 de Specter?"
• "¿Mi proyecto de Specter está configurado correctamente?"

Comprobar la versión y actualizar

# 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 almacena en caché los paquetes durante ~24h. Si update obtiene una versión antigua, fuerza la última con npx specter-skills@latest update. El servidor MCP (npx … specter-mcp) siempre obtiene la última versión publicada de la misma manera.

Requisitos

• Node.js 18+
• Un proyecto de Specter + clave de API (console.specterapp.xyz)
• Un host de Claude compatible con habilidades (Claude Code, Claude Desktop o el Agent SDK) para las habilidades; un host compatible con MCP para el servidor

Solución de problemas

Enlaces

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

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