skene 0.4.0

PLG analysis toolkit for codebases - analyze code, detect growth opportunities, generate documentation

   

Skene is a codebase analysis toolkit for product-led growth. It models your product's user journey from your schema and code, surfaces growth opportunities, and turns them into actionable implementation plans.

Quick Start

Install and launch the interactive terminal UI:

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

The wizard walks you through provider selection, authentication, and analysis — no configuration needed upfront.

What It Does

• Journey-first analysis -- compiles a view of your product's user journey: lifecycle stages, milestones, and value points, derived from your schema and code
• Journey visualizer -- opens the compiled journey in a local web app, with the lifecycle stages and milestones laid out as a diagram alongside the underlying data
• Tech stack detection -- identifies frameworks, databases, auth, deployment
• Growth feature discovery -- finds existing signup flows, sharing, invites, billing
• Feature registry -- tracks features across analysis runs, links them to growth loops
• Revenue leakage analysis -- spots missing monetization and weak pricing tiers
• Growth plan generation -- produces prioritized growth loops with implementation roadmaps
• Implementation prompts -- builds ready-to-use prompts for Cursor, Claude, or other AI tools
• Telemetry deployment -- when an engine.yaml is present, build writes supabase/migrations/*_skene_triggers.sql; push sends whatever bundle files exist to upstream
• Loop validation -- verifies that growth loop requirements are implemented (Python, JavaScript, TypeScript)

Supports OpenAI, Gemini, Claude, LM Studio, Ollama, and any OpenAI-compatible endpoint. Free local audit available with no API key required.

Installation

Terminal UI (recommended)

The TUI is an interactive wizard that guides you through the entire workflow. No prerequisites — the installer handles everything.

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

# Launch it
skene

Python CLI

If you prefer the command line, you can run Skene directly with uvx (no install needed) or install it globally:

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

# Run directly (no install needed)
uvx skene

# Or install globally
pip install skene

For CLI usage details, see the documentation.

Output Layout

Both the Python CLI (including analyse-journey, analyze, plan, and build) and the interactive TUI write their artifacts to a single bundle directory in your project root. The directory is created automatically when it is missing.

• Default: ./skene-context/ — holds schema.yaml, engine.yaml, growth-manifest.json, growth-template.json, growth-plan.md, feature-registry.json, and related assets.
• Upgrading from v0.3.x: delete any existing ./skene/ or ./skene-context/ directories before re-running, so the new analysis starts from a clean slate.
• Override: set output_dir in .skene.config or pass -o/--output to a specific command to write elsewhere.

Monorepo Structure

Directory	Description	Language	Distribution
src/skene/	CLI + analysis engine	Python	PyPI
tui/	Interactive terminal UI wizard	Go	GitHub Releases
cursor-plugin/	Cursor IDE plugin	—	—
skills/	Skene Skills -- composable backend schemas for Supabase	SQL	npm

The TUI (tui/) is a Bubble Tea app that provides an interactive wizard experience and orchestrates the Python CLI via uvx. Each package has independent CI/CD pipelines.

Contributing

Contributions are welcome. Please open an issue or submit a pull request.

License

MIT