{"id":"3d6b1c37-de5a-43e1-b261-87644f25856c","slug":"skene","kind":"mcp","name":"skene","summary":"Product-Led Growth (PLG) analysis toolkit that detects tech stacks, plans growth loops and builds the loop iteratively.","owner":"SkeneTechnologies","repoUrl":"https://github.com/SkeneTechnologies/skene","license":"MIT","licenseTier":"permissive","trust":"community","stars":128,"match":null,"fewStars":false,"format":"mcp","createdAt":"2026-01-07T14:04:34.000Z","addedAt":"2026-10-14T03:44:09.141Z","logoUrl":"https://avatars.githubusercontent.com/u/236755742?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools","cloud-infra","writing"],"tags":["ai-tools","anthropic","automation","cli","cli-tool","code-documentation","codebase-analysis","developer-tools"],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-15T02:53:29.726Z","sample":false,"url":"https://conduits.dev/tools/skene","language":"Go","transports":["stdio"],"install":{"pypi":"skene"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"

\n \"Skene_git\"\n

\n\n\n\n

\n \"website\" \"docs\" \"blog\" \"reddit\"\n

\n\n\nSkene reads your codebase and produces a **user journey** for your product: the lifecycle stages a user moves through, the milestones inside each stage, and the code or database evidence that proves each milestone is real.\n\n## Quick Start\n\nInstall and launch the interactive terminal UI:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash\nskene\n```\n\nThe wizard walks you through provider selection, authentication, and analysis — no configuration needed upfront.\n\n

\n \n

\n\n## What It Does\n\nSkene turns a repository into a single `journey.yaml` describing your product's user lifecycle, and renders it as an interactive diagram.\n\n- **Agentic analysis** — two parallel agents read your project: one walks the codebase, one walks your SQL schemas. They each propose candidate milestones, which are then merged and classified into a canonical seven-stage lifecycle.\n- **Seven-stage user journey** — every product maps to the same canonical stages (*discovery, onboarding, activation, engagement, retention, expansion, virality*) so journeys are comparable across products. Stage names are specialized to your product where useful.\n- **Evidence-backed milestones** — each milestone carries a `tracked_event`, a `confidence` score, and one or more `evidence` chips pointing back to the exact code path, database table, or config file that justifies it.\n- **Journey visualizer** — the TUI opens a local web app that lays out the stages as columns, with milestone cards and clickable evidence chips, so you can review the journey alongside the underlying source.\n- **Code-only, schema-only, or both** — run against just a codebase, just a directory of `*.sql` files, or both for richer evidence.\n\nSupports OpenAI, Gemini, Claude, LM Studio, Ollama, and any OpenAI-compatible endpoint.\n\n\"ide_git\"\n\n## Installation\n\n### Terminal UI (recommended)\n\nThe TUI is an interactive wizard that guides you through the entire workflow. No prerequisites — the installer handles everything.\n\n```bash\n# Install the TUI\ncurl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash\n\n# Launch it\nskene\n```\n\n### Python CLI\n\nIf you prefer the command line, you can run Skene directly with `uvx` (no install needed) or install it globally:\n\n```bash\n# Install uv (if you don't have it)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Run directly (no install needed)\nuvx skene analyse-journey .\n\n# Or install globally\npip install skene\nskene analyse-journey .\n```\n\nUseful flags:\n\n- `--schema-dir

` — point at a directory of exported `*.sql` files to enable the schema agent\n- `-o ` — override the output file (default `./skene-context/journey.yaml`)\n- `--no-specialize` — keep the canonical stage names instead of letting the LLM specialize them\n\nFor full CLI usage, see the [documentation](https://www.skene.ai/resources/docs/skene).\n\n## Output Layout\n\nBoth the Python CLI and the TUI write artifacts to a single bundle directory in your project root, created automatically if missing.\n\n- **Default:** `./skene-context/journey.yaml` — the analysed user journey for your product.\n- **Override:** set `output_dir` in `.skene.config` or pass `-o`/`--output` to write elsewhere.\n\n## Monorepo Structure\n\n| Directory | Description | Language | Distribution |\n|-----------|-------------|----------|-------------|\n| `src/skene/` | CLI + analysis engine | Python | [PyPI](https://pypi.org/project/skene/) |\n| `tui/` | Interactive terminal UI wizard | Go | [GitHub Releases](https://github.com/SkeneTechnologies/skene/releases) |\n| `cursor-plugin/` | Cursor IDE plugin | — | — |\n\nThe 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.\n\n## Contributing\n\nContributions are welcome. Please [open an issue](https://github.com/SkeneTechnologies/skene/issues) or submit a [pull request](https://github.com/SkeneTechnologies/skene/pulls).\n\n## License\n\n[MIT](https://opensource.org/licenses/MIT)\n\n\"Skene_end_git\"\n"}