Skene
oficialSkene es un conjunto de herramientas de análisis de código base para el crecimiento impulsado por el producto. Escanea tu código base, detecta oportunidades de crecimiento y genera planes de implementación accionables.
¿Qué puedes hacer con Skene MCP?
- Analizar un codebase en un journey de usuario — Pídele a tu IA que ejecute
analyse-journeyen un repositorio y genere unjourney.yamlque mapee las etapas del ciclo de vida, los hitos y la evidencia. - Combinar el análisis de código y esquemas SQL — Apunta Skene a un directorio de archivos
*.sqlcon--schema-dirpara que tanto el código como la evidencia de la base de datos respalden cada hito. - Personalizar la salida del journey — Usa
-opara redirigir eljourney.yamlgenerado a una ruta específica, o--no-specializepara mantener los nombres de etapa canónicos en lugar de los específicos del producto. - Iniciar el asistente de configuración interactivo — Haz que tu IA te guíe a través de la instalación y ejecución de la TUI de
skene, que maneja la selección de proveedor y la autenticación de forma interactiva.
Documentación
Skene lee tu código y produce un recorrido de 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 de código o base de datos que demuestra que cada hito es real.
Inicio rápido
Instala y lanza la interfaz de terminal interactiva:
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene
El asistente te guía a través de la selección del proveedor, la autenticación y el 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 renderiza como un diagrama interactivo.
- Análisis agéntico — dos agentes paralelos leen tu proyecto: uno recorre el 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 de usuario de 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 según tu producto cuando es útil.
- Hitos respaldados por evidencia — cada hito lleva un
tracked_event, una puntuación deconfidencey una o más etiquetas deevidenceque apuntan de vuelta a la ruta de código exacta, la tabla de base de datos o el archivo de configuración que lo justifica. - Visualizador de recorridos — la TUI abre una aplicación web local que organiza las etapas en columnas, con tarjetas de hitos y etiquetas de evidencia clicables, para que puedas revisar el recorrido junto con el código fuente subyacente.
- Solo código, solo esquema, o ambos — ejecuta solo contra un código, solo contra un directorio de archivos
*.sql, o 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 a través de 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 instalación) 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 .
Banderas útiles:
--schema-dir <dir>— apunta a un directorio de archivos*.sqlexportados para habilitar el agente de esquemas-o <path>— sobrescribe el archivo de salida (por defecto./skene-context/journey.yaml)--no-specialize— mantén los nombres de etapas canónicos en lugar de dejar que el LLM los especialice
Para el uso completo de la CLI, consulta la documentación.
Diseño de salida
Tanto el CLI de Python como la TUI escriben artefactos en un único directorio de paquetes en la raíz de tu proyecto, creado automáticamente si falta.
- Por defecto:
./skene-context/journey.yaml— el recorrido de usuario analizado para tu producto. - Sobrescribir: establece
output_diren.skene.configo pasa-o/--outputpara escribir en otro lugar.
Estructura del monorepositorio
| Directorio | Descripción | Lenguaje | Distribución |
|---|---|---|---|
src/skene/ | CLI + motor de análisis | Python | PyPI |
tui/ | Asistente interactivo de interfaz de terminal | Go | GitHub Releases |
cursor-plugin/ | Plugin del IDE Cursor | — | — |
La TUI (tui/) es una aplicación Bubble Tea que proporciona una experiencia de asistente interactivo y orquesta el CLI de Python a través de 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.