Skip to content
Back to search

truepath

MarketplaceWorks with Claude CodeGitHub

Agent skill: self-contained HTML simulations of a process or a bug path, whose verdicts come from the repository's own code

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/bastien-gallay--truepath/badge.svg)](/listings/bastien-gallay--truepath)

HTML

<a href="/listings/bastien-gallay--truepath"><img src="/api/listings/bastien-gallay--truepath/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

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

In Claude Code, as a plugin from this repository:

/plugin marketplace add bastien-gallay/truepath
/plugin install truepath@truepath

Or from the [skills hub](https://github.com/bastien-gallay/skills), with the other skills I maintain:

/plugin marketplace add bastien-gallay/skills
/plugin install truepath@skills

For another agent, clone the repository and copy `skills/truepath/` into the skills folder it reads:

git clone https://github.com/bastien-gallay/truepath.git
cp -R truepath/skills/truepath ~/.claude/skills/

Needs Python 3.9 or later (standard library only) and, for a JavaScript port or a JavaScript oracle, Node.js. The page works offline: no web font, no CDN.

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.

.claude-plugin/marketplace.json · Manifest · 29 lines
  1. {
  2. "name": "truepath",
  3. "owner": {
  4. "name": "Bastien Gallay"
  5. },
  6. "metadata": {
  7. "description": "truepath — single-plugin marketplace.",
  8. "version": "0.1.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "truepath",
  13. "source": "./",
  14. "description": "Self-contained HTML simulations of a process or a bug path, whose verdicts come from the repository's own code; the build refuses any scenario that contradicts them.",
  15. "version": "0.1.0",
  16. "license": "MIT",
  17. "homepage": "https://github.com/bastien-gallay/truepath",
  18. "repository": "https://github.com/bastien-gallay/truepath",
  19. "category": "productivity",
  20. "tags": [
  21. "simulation",
  22. "process",
  23. "diagram",
  24. "before-after",
  25. "documentation"
  26. ]
  27. }
  28. ]
  29. }
README.md · README · 126 lines
  1. # truepath
  2. [![ci](https://github.com/bastien-gallay/truepath/actions/workflows/ci.yml/badge.svg)](https://github.com/bastien-gallay/truepath/actions/workflows/ci.yml)
  3. An agent skill that turns a process, a bug path or a rule under discussion
  4. into one self-contained HTML page: a dot walks the real path through the
  5. graph, a data panel shows what changes at each step, and two scenarios play
  6. side by side with their first difference marked.
  7. What makes it more than an animation: the verdicts come from your
  8. repository's own code, run on a frozen `git archive` of a ref, or from a
  9. declared port of it. The build checks every scenario against them and
  10. writes nothing if one disagrees.
  11. ![A before/after pair: the same refund request refused on the left, granted
  12. on the right, the decision where they part outlined
  13. ](docs/refund-window.png)
  14. ```text
  15. spec.json ──┐
  16. oracle/port ├─► build.py ──► checks C1–C13 ─► sim.html (or nothing)
  17. layout.py ──┘ └► fixture.json (--export)
  18. ```
  19. ## Status
  20. 0.1.0, first public version, tagged
  21. [`v0.1.0`](https://github.com/bastien-gallay/truepath/releases/tag/v0.1.0)
  22. on 2026-11-16. The spec vocabulary may still change before
  23. 1.0; [`CHANGELOG.md`](CHANGELOG.md) says what did. The examples build with 0
  24. violations, and the two that keep their page rebuild it byte for byte; the
  25. tests check both on every push to `main` and every pull request.
  26. Known limits are listed under *Limits* in
  27. [`SKILL.md`](skills/truepath/SKILL.md).
  28. ## Install
  29. In Claude Code, as a plugin from this repository:
  30. ```text
  31. /plugin marketplace add bastien-gallay/truepath
  32. /plugin install truepath@truepath
  33. ```
  34. Or from the [skills hub](https://github.com/bastien-gallay/skills), with the
  35. other skills I maintain:
  36. ```text
  37. /plugin marketplace add bastien-gallay/skills
  38. /plugin install truepath@skills
  39. ```
  40. For another agent, clone the repository and copy `skills/truepath/` into the
  41. skills folder it reads:
  42. ```sh
  43. git clone https://github.com/bastien-gallay/truepath.git
  44. cp -R truepath/skills/truepath ~/.claude/skills/
  45. ```
  46. Needs Python 3.9 or later (standard library only) and, for a JavaScript port
  47. or a JavaScript oracle, Node.js. The page works offline: no web font, no CDN.
  48. ## Try it
  49. ```sh
  50. python3 skills/truepath/scripts/build.py skills/truepath/examples/refund-window/spec.json
  51. ```
  52. Then open `skills/truepath/examples/refund-window/sim.html`: a refund asked
  53. on day 30, refused before an off-by-one fix and granted after it.
  54. | Example | Shows | Verdicts from |
  55. | --- | --- | --- |
  56. | [`refund-window`](skills/truepath/examples/refund-window/) | a before/after pair | a JS port |
  57. | [`free-shipping`](skills/truepath/examples/free-shipping/) | a grid: two open questions against three cases | a JS port |
  58. | [`loyalty-tier`](skills/truepath/examples/loyalty-tier/) | an oracle, and the fixture it exports | the folder's own `src/tier.js`, as committed |
  59. `loyalty-tier` reads its code through `git archive`, so it builds from a
  60. clone of this repository, not from a bare copy of the folder.
  61. ## What it covers
  62. - one scenario, played step by step;
  63. - a before/after pair, its first divergence outlined;
  64. - a grid of cases against the answers to one or more open questions, the
  65. matrix first, each cell opening the case.
  66. ![The free-shipping grid: the matrix of cases against answers, then a click
  67. on a cell that differs plays that case, today next to the answer
  68. ](docs/free-shipping.gif)
  69. The full contract is in [`skills/truepath/SKILL.md`](skills/truepath/SKILL.md).
  70. ## Develop
  71. ```sh
  72. python3 -m unittest discover -s tests
  73. ```
  74. The tests break each check's input once and expect the build to refuse, then
  75. play the built pages step by step under Node.js, without a browser. CI runs
  76. them on Python 3.9 and 3.13, with `ruff check` on the code and
  77. `markdownlint-cli2` on the docs.
  78. ## Related skills
  79. truepath is listed in [bastien-gallay/skills](https://github.com/bastien-gallay/skills),
  80. the registry of the skills I maintain. Two of them meet it often:
  81. - [`show-me`](https://github.com/bastien-gallay/show-me) picks the visual a
  82. piece of content calls for; truepath builds one of them, the path through
  83. a process, and checks it against the code.
  84. - [`wrap`](https://github.com/bastien-gallay/wrap) closes a milestone; its
  85. configuration for this repository is [`.wrap.md`](.wrap.md).
  86. ## Influences
  87. [dashmotion](https://csthink.github.io/dashmotion/) showed how much a
  88. diagram gains when something visibly travels along its edges. truepath takes
  89. that idea somewhere else: a single dot, moved step by step by a scenario,
  90. on a path the code has to agree with.
  91. ## License
  92. MIT, see [`LICENSE`](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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