Skip to content
Back to search

skene

Product-Led Growth (PLG) analysis toolkit that detects tech stacks, plans growth loops and builds the loop iteratively.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/skenetechnologies--skene/badge.svg)](/listings/skenetechnologies--skene)

HTML

<a href="/listings/skenetechnologies--skene"><img src="/api/listings/skenetechnologies--skene/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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.

<p align="center"> <p>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 106 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img alt="Skene_git" src="https://github.com/user-attachments/assets/2be11c04-6b98-4e26-8905-bf3250c4addb" width="100%" height="auto" />
  3. </p>
  4. <p align="center">
  5. <a href="https://www.skene.ai"><img width="120" height="42" alt="website" src="https://github.com/user-attachments/assets/8ae8c68f-eeb5-411f-832f-6b6818bd2c34"></a>&nbsp;<a href="https://www.skene.ai/resources/docs/skene"><img width="120" height="42" alt="docs" src="https://github.com/user-attachments/assets/f847af52-0f6f-4570-9a48-1b7c8f4f0d7a"></a>&nbsp;<a href="https://www.skene.ai/resources/blog"><img width="100" height="42" alt="blog" src="https://github.com/user-attachments/assets/8c62e3b8-39a8-43f6-bb0b-f00b118aff82"></a>&nbsp;<a href="https://www.reddit.com/r/plgbuilders/"><img width="153" height="42" alt="reddit" src="https://github.com/user-attachments/assets/b420ea50-26e3-40fe-ab34-ac179f748357"></a>
  6. </p>
  7. Skene 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.
  8. ## Quick Start
  9. Install and launch the interactive terminal UI:
  10. ```bash
  11. curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 19 on GitHub
  12. skene
  13. ```
  14. The wizard walks you through provider selection, authentication, and analysis — no configuration needed upfront.
  15. <p align="center">
  16. <img src="https://github.com/user-attachments/assets/49dcd0c4-2bad-4fd3-b29e-89ba2b85c669" width="100%" height="auto"/>
  17. <p>
  18. ## What It Does
  19. Skene turns a repository into a single `journey.yaml` describing your product's user lifecycle, and renders it as an interactive diagram.
  20. - **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.
  21. - **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.
  22. - **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.
  23. - **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.
  24. - **Code-only, schema-only, or both** — run against just a codebase, just a directory of `*.sql` files, or both for richer evidence.
  25. Supports OpenAI, Gemini, Claude, LM Studio, Ollama, and any OpenAI-compatible endpoint.
  26. <img width="1662" height="393" alt="ide_git" src="https://github.com/user-attachments/assets/0b9de3f8-9083-4dc8-b68e-105abc7ea0b4" />
  27. ## Installation
  28. ### Terminal UI (recommended)
  29. The TUI is an interactive wizard that guides you through the entire workflow. No prerequisites — the installer handles everything.
  30. ```bash
  31. # Install the TUI
  32. curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 51 on GitHub
  33. # Launch it
  34. skene
  35. ```
  36. ### Python CLI
  37. If you prefer the command line, you can run Skene directly with `uvx` (no install needed) or install it globally:
  38. ```bash
  39. # Install uv (if you don't have it)
  40. curl -LsSf https://astral.sh/uv/install.sh | sh
  41. # Run directly (no install needed)
  42. uvx skene analyse-journey .
  43. # Or install globally
  44. pip install skene
  45. skene analyse-journey .
  46. ```
  47. Useful flags:
  48. - `--schema-dir <dir>` — point at a directory of exported `*.sql` files to enable the schema agent
  49. - `-o <path>` — override the output file (default `./skene-context/journey.yaml`)
  50. - `--no-specialize` — keep the canonical stage names instead of letting the LLM specialize them
  51. For full CLI usage, see the [documentation](https://www.skene.ai/resources/docs/skene).
  52. ## Output Layout
  53. Both the Python CLI and the TUI write artifacts to a single bundle directory in your project root, created automatically if missing.
  54. - **Default:** `./skene-context/journey.yaml` — the analysed user journey for your product.
  55. - **Override:** set `output_dir` in `.skene.config` or pass `-o`/`--output` to write elsewhere.
  56. ## Monorepo Structure
  57. | Directory | Description | Language | Distribution |
  58. |-----------|-------------|----------|-------------|
  59. | `src/skene/` | CLI + analysis engine | Python | [PyPI](https://pypi.org/project/skene/) |
  60. | `tui/` | Interactive terminal UI wizard | Go | [GitHub Releases](https://github.com/SkeneTechnologies/skene/releases) |
  61. | `cursor-plugin/` | Cursor IDE plugin | — | — |
  62. 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.
  63. ## Contributing
  64. Contributions are welcome. Please [open an issue](https://github.com/SkeneTechnologies/skene/issues) or submit a [pull request](https://github.com/SkeneTechnologies/skene/pulls).
  65. ## License
  66. [MIT](https://opensource.org/licenses/MIT)
  67. <img alt="Skene_end_git" src="https://github.com/user-attachments/assets/04119cd1-ee00-4902-9075-5fc3e1e5ec48" width="100%" height="auto" />

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.