Skene MCP Server

   

Skene lee tu base de código y produce un recorrido del usuario para tu producto: las etapas del ciclo de vida por las que pasa un usuario, los hitos dentro de cada etapa y la evidencia en código o base de datos que demuestra que cada hito es real.

Inicio rápido

Instala e inicia la interfaz de terminal interactiva:

curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene

El asistente te guía por la selección de proveedor, autenticación y análisis — sin necesidad de configuración previa.

Qué hace

Skene convierte un repositorio en un único journey.yaml que describe el ciclo de vida del usuario de tu producto, y lo representa como un diagrama interactivo.

• Análisis agentivo — dos agentes paralelos leen tu proyecto: uno recorre la base de código, otro recorre tus esquemas SQL. Cada uno propone hitos candidatos, que luego se fusionan y clasifican en un ciclo de vida canónico de siete etapas.
• Recorrido del usuario en siete etapas — cada producto se asigna a las mismas etapas canónicas (descubrimiento, incorporación, activación, compromiso, retención, expansión, viralidad) para que los recorridos sean comparables entre productos. Los nombres de las etapas se especializan para tu producto cuando es útil.
• Hitos respaldados por evidencia — cada hito lleva un tracked_event, una puntuación de confidence y una o más etiquetas de evidence que apuntan a la ruta de código exacta, tabla de base de datos o archivo de configuración que lo justifica.
• Visualizador del recorrido — la TUI abre una aplicación web local que presenta las etapas como columnas, con tarjetas de hitos y etiquetas de evidencia cliqueables, para que puedas revisar el recorrido junto al código fuente subyacente.
• Solo código, solo esquema o ambos — ejecuta el análisis solo sobre una base de código, solo sobre un directorio de archivos *.sql, o sobre ambos para una evidencia más rica.

Compatible con OpenAI, Gemini, Claude, LM Studio, Ollama y cualquier endpoint compatible con OpenAI.

Instalación

Interfaz de terminal (recomendada)

La TUI es un asistente interactivo que te guía por todo el flujo de trabajo. Sin requisitos previos — el instalador se encarga de todo.

# Install the TUI
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash

# Launch it
skene

CLI de Python

Si prefieres la línea de comandos, puedes ejecutar Skene directamente con uvx (sin necesidad de instalar) o instalarlo globalmente:

# Install uv (if you don't have it)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run directly (no install needed)
uvx skene analyse-journey .

# Or install globally
pip install skene
skene analyse-journey .

Opciones útiles:

• --schema-dir <dir> — apunta a un directorio de archivos *.sql exportados para habilitar el agente de esquema
• -o <path> — sobrescribe el archivo de salida (por defecto ./skene-context/journey.yaml)
• --no-specialize — mantiene los nombres de etapa canónicos en lugar de dejar que el LLM los especialice

Para el uso completo de la CLI, consulta la documentación.

Estructura de salida

Tanto la CLI de Python como la TUI escriben los artefactos en un único directorio de paquete en la raíz de tu proyecto, que se crea automáticamente si no existe.

• Por defecto: ./skene-context/journey.yaml — el recorrido del usuario analizado para tu producto.
• Sobrescribir: establece output_dir en .skene.config o pasa -o/--output para escribir en otra ubicación.

Estructura del monorepo

Directorio	Descripción	Lenguaje	Distribución
src/skene/	CLI + motor de análisis	Python	PyPI
tui/	Asistente interactivo de terminal	Go	GitHub Releases
cursor-plugin/	Plugin para Cursor IDE	—	—
skills/	Skene Skills — esquemas de backend componibles para Supabase	SQL	npm

La TUI (tui/) es una aplicación Bubble Tea que proporciona una experiencia de asistente interactivo y orquesta la CLI de Python mediante uvx. Cada paquete tiene pipelines de CI/CD independientes.

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue o envía un pull request.

Licencia

MIT