skene-growth

PLG (Product-Led Growth) codebase analysis toolkit. Scan your codebase, detect growth opportunities, and generate actionable implementation plans.

Quick Start

uvx skene-growth config --init   # Create config file
uvx skene-growth config          # Set provider, model, API key
uvx skene-growth analyze .       # Analyze your codebase
uvx skene-growth plan            # Generate a growth plan
uvx skene-growth build           # Build an implementation prompt
uvx skene-growth status          # Check loop implementation status

What It Does

• Tech stack detection -- identifies frameworks, databases, auth, deployment
• Growth feature discovery -- finds existing signup flows, sharing, invites, billing
• 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
• Loop validation -- AST-based checks verify that growth loop requirements are implemented
• Interactive chat -- ask questions about your codebase in the terminal

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

Installation

# Install uv (if you don't have it)
curl -LsSf https://astral.sh/uv/install.sh | sh
Recommended (no install needed)
uvx skene-growth
Or install globally
pip install skene-growth

Documentation

Full documentation: www.skene.ai/resources/docs/skene-growth

MCP Server

skene-growth includes an MCP server for integration with AI assistants. Add to your assistant config:

{
  "mcpServers": {
    "skene-growth": {
      "command": "uvx",
      "args": ["--from", "skene-growth[mcp]", "skene-growth-mcp"],
      "env": {
        "SKENE_API_KEY": "your-api-key"
      }
    }
  }
}

Monorepo Structure

This repository contains two independent packages:

Directory	Description	Language	Distribution
src/skene_growth/	CLI + analysis engine	Python	PyPI
tui/	Interactive terminal UI wizard	Go	GitHub Releases

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 on GitHub.

License

MIT