Skip to content
Back to search

task-tree-marketplace

MarketplaceWorks with Claude CodeGitHub

Traceable living task trees for Claude Code.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dylanshi-cloud/task-tree with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dylanshi-cloud/task-tree'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dylanshi-cloud--task-tree/badge.svg)](/listings/dylanshi-cloud--task-tree)

HTML

<a href="/listings/dylanshi-cloud--task-tree"><img src="/api/listings/dylanshi-cloud--task-tree/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.

Plugin marketplace

/plugin install task-tree --marketplace dylanshi-cloud/task-tree

Or add the marketplace first, then install:

/plugin marketplace add dylanshi-cloud/task-tree
/plugin install task-tree@task-tree-marketplace

Both the plugin and marketplace manifests live in `.claude-plugin/`; validate them with `claude plugin validate --strict .`.

Standalone skill

git clone https://github.com/dylanshi-cloud/task-tree.git ~/.claude/skills/task-tree

Or copy the folder into `~/.claude/skills/task-tree/` (`%USERPROFILE%\.claude\skills\task-tree\` on Windows).

Requirements: Python 3.10+ (stdlib only), Obsidian for the rendered view, macOS/Windows/Linux.

Point it at a vault

Choose one:

- `--vault /path/to/ObsidianVault` - `TASK_TREE_VAULT=/path/to/ObsidianVault` - `~/.config/task-tree/config.json`:

{ "vault": "/Users/you/Desktop/ObsidianVault" }

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 · 16 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "task-tree-marketplace",
  4. "description": "Traceable living task trees for Claude Code.",
  5. "owner": {
  6. "name": "Dylan Shi"
  7. },
  8. "plugins": [
  9. {
  10. "name": "task-tree",
  11. "description": "Clarify intent, split work into a tree, and keep a visible growth and collaboration trail in Obsidian.",
  12. "source": "./",
  13. "category": "productivity"
  14. }
  15. ]
  16. }
README.md · README · 176 lines
  1. # task-tree
  2. **A traceable, living task tree for Claude Code — intent, work, evidence, and drift control in one source of truth.**
  3. Most agent workflows lose the *why* after the first few turns. `task-tree` keeps a single JSON source for the mission, branches, acceptance criteria, decisions, and calibrations, then renders it as a read-only Obsidian mirror: a canvas, linked notes, a calibration ledger, and a growth chart that shows what actually moved.
  4. > 中文说明见 [README.zh-CN.md](README.zh-CN.md)。v0.1 UI strings are Chinese; English UI is on the roadmap.
  5. ## Why it exists
  6. - **Intent first.** The skill asks *why / for whom / what counts as success / what is out of scope* before splitting work.
  7. - **One source of truth.** `tree.json` is the only state. Notes and canvases are generated, never hand-edited.
  8. - **Calibration instead of overwrite.** Goal changes append to `calibrations`; stale numbers are caught by `drift_checks`.
  9. - **Growth is visible.** Every run records a snapshot. The growth page shows new nodes, state transitions, who did what, and a stacked-bar chart of the last 24 runs.
  10. - **Collaboration is explicit.** `roles` and per-node `owner` produce a “who is doing what / what needs your decision / what is blocked” view.
  11. - **Low overhead.** One JSON file and one generator run per round. Small tasks use a one-branch, ≤3-node tree.
  12. ## What gets generated
  13. ```text
  14. <vault>/50 任务树/
  15. ├── 任务总览.md # cross-task index
  16. └── <program>/
  17. ├── <title>.md # root: mission, users, success, current, collaboration
  18. ├── 分支/ # one page per branch
  19. ├── 节点/ # one page per deliverable
  20. ├── <title> 口径校准.md # current canonical values + calibration history + drift scan
  21. ├── <title> 演进时间线.md # decisions and daily log
  22. ├── <title> 生长.md + .svg # this round's delta + growth chart
  23. └── <title>.canvas # visual map for Obsidian
  24. ```
  25. Each node page carries: why it exists, its success criterion, next action, evidence, linked decisions, lessons, and a 🆕/🔄 badge when it changed this round.
  26. ## Install
  27. ### Plugin marketplace
  28. ```text
  29. /plugin install task-tree --marketplace dylanshi-cloud/task-tree
  30. ```
  31. Or add the marketplace first, then install:
  32. ```text
  33. /plugin marketplace add dylanshi-cloud/task-tree
  34. /plugin install task-tree@task-tree-marketplace
  35. ```
  36. Both the plugin and marketplace manifests live in `.claude-plugin/`; validate
  37. them with `claude plugin validate --strict .`.
  38. ### Standalone skill
  39. ```bash
  40. git clone https://github.com/dylanshi-cloud/task-tree.git ~/.claude/skills/task-tree
  41. ```
  42. Or copy the folder into `~/.claude/skills/task-tree/` (`%USERPROFILE%\.claude\skills\task-tree\` on Windows).
  43. Requirements: Python 3.10+ (stdlib only), Obsidian for the rendered view, macOS/Windows/Linux.
  44. ### Point it at a vault
  45. Choose one:
  46. - `--vault /path/to/ObsidianVault`
  47. - `TASK_TREE_VAULT=/path/to/ObsidianVault`
  48. - `~/.config/task-tree/config.json`:
  49. ```json
  50. { "vault": "/Users/you/Desktop/ObsidianVault" }
  51. ```
  52. ## Quick start
  53. ```bash
  54. cp templates/tree.json .task-tree/my-task/tree.json
  55. # edit program, title, mission, branches, nodes
  56. python3 ~/.claude/skills/task-tree/scripts/build_task_tree.py \
  57. --tree .task-tree/my-task/tree.json
  58. ```
  59. The generator prints the task folder and an `obsidian://` link, and opens the canvas automatically. Use `--no-open` to disable.
  60. Run the built-in example:
  61. ```bash
  62. python3 scripts/build_task_tree.py \
  63. --tree templates/tree.json \
  64. --vault /tmp/task-tree-test --no-open
  65. ```
  66. Expected: 13 notes, 1 canvas, 1 SVG.
  67. A lightweight one-branch example:
  68. ```bash
  69. python3 scripts/build_task_tree.py \
  70. --tree examples/small-task.json \
  71. --vault /tmp/task-tree-example \
  72. --history /tmp/task-tree-example-history.json --no-open
  73. ```
  74. ## Data model
  75. See [`templates/tree.json`](templates/tree.json) for a complete example and [`schema/tree.schema.json`](schema/tree.schema.json) for the machine-readable schema.
  76. Core fields:
  77. | Field | Purpose |
  78. |---|---|
  79. | `program` | Short slug; also the output folder name (`[A-Za-z0-9._-]`) |
  80. | `title` | Human-readable tree title |
  81. | `roles` | Who is responsible for what (`Claude`, user, external) |
  82. | `mission` | `why`, `who`, `non_goals`, `success[]` |
  83. | `branches` | 3–9 areas; each says why it exists and which success criteria it serves |
  84. | `nodes` | Deliverables with `state`, `owner`, `judge`, `next`, `evidence` |
  85. | `decisions` | Decisions with ids, dates, status |
  86. | `calibrations` | Goal/approach/scope changes; append-only |
  87. | `drift_checks` | Canonical values and stale patterns to scan |
  88. | `current` | The one thing being worked on now |
  89. States: `done | partial | open | decide | blocked | later`.
  90. ## How the skill is used
  91. `SKILL.md` defines the three-step protocol:
  92. 1. **Clarify intent** until you can restate it without the user changing keywords.
  93. 2. **Split into root → branches → nodes**, each node independently acceptable.
  94. 3. **Confirm, then execute** one node at a time; update the JSON and regenerate at the end of each round.
  95. The bundled script handles rendering, history snapshots, drift scanning, cross-task indexing, and opening the result in Obsidian.
  96. ## Security and trust
  97. - `tree.json` is treated as untrusted input: `program` is validated to prevent path traversal, filenames are sanitized, JSON parse errors are reported with line/column.
  98. - Generated files are marked with `generator: task-tree skill`; cleanup only deletes files carrying that marker.
  99. - No network calls, no third-party dependencies.
  100. - The generator writes only inside `<vault>/50 任务树/`.
  101. See [SECURITY.md](SECURITY.md) for reporting.
  102. ## Tests
  103. ```bash
  104. python3 -m unittest discover -s tests -v
  105. ```
  106. CI runs the suite on Linux, macOS, and Windows across Python 3.10–3.12.
  107. ## Repository layout
  108. ```text
  109. .claude-plugin/ # plugin.json, marketplace.json, icon
  110. SKILL.md # the skill Claude loads
  111. scripts/build_task_tree.py
  112. templates/ # tree.json + config.json
  113. examples/ # lightweight one-branch example
  114. schema/tree.schema.json # editor/CI schema
  115. tests/ # integration tests
  116. evals/ # realistic prompts for skill evaluation
  117. .github/workflows/ # CI
  118. ```
  119. ## Status
  120. v0.1.1 — core loop and release scaffolding are complete; the plugin and
  121. marketplace manifests pass `claude plugin validate`. Known gaps: English UI
  122. strings, demo screenshots/GIF, and the first public repository push. See
  123. [CHANGELOG.md](CHANGELOG.md).
  124. ## License
  125. 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.