# Send TreeListy to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "treelisty-openclaw-skill",
    "name": "TreeListy",
    "source": "tencent",
    "type": "skill",
    "category": "其他",
    "sourceUrl": "https://clawhub.ai/Prairie2Cloud/treelisty-openclaw-skill",
    "canonicalUrl": "https://clawhub.ai/Prairie2Cloud/treelisty-openclaw-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/treelisty-openclaw-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=treelisty-openclaw-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "package-lock.json",
      "package.json",
      "references/PATTERNS.md",
      "scripts/decompose.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/treelisty-openclaw-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/treelisty-openclaw-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/treelisty-openclaw-skill",
    "agentUrl": "https://openagent3.xyz/skills/treelisty-openclaw-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/treelisty-openclaw-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/treelisty-openclaw-skill/agent.md"
  }
}
```
## Documentation

### TreeListy Skill

TreeListy is your hierarchical decomposition engine. When you need to break down a complex topic, plan a project, or structure information in a tree format, use TreeListy.

### When to Use This Skill

Use TreeListy when:

Decomposing complex tasks — Break a large goal into phases, items, and actionable tasks
Project planning — Create WBS, roadmaps, or strategic plans with proper hierarchy
Structuring analysis — Organize arguments (philosophy), dialogues, or knowledge bases
Content organization — Plan books, courses, theses, or event schedules
Visual documentation — Generate Mermaid diagrams for any hierarchical structure

### Quick Start

# List available patterns
node scripts/treelisty-cli.js patterns

# Create a structured decomposition
node scripts/treelisty-cli.js decompose --pattern wbs --input "Build a mobile app"

# Export to Mermaid diagram
node scripts/treelisty-cli.js export --input tree.json --format mermaid

### The 21 Patterns

PatternIconBest Forgeneric📋General projects, default structuresales💼Sales pipelines, quarterly dealsthesis🎓Academic papers, dissertationsroadmap🚀Product roadmaps, feature planningbook📚Books, novels, screenplay structureevent🎉Event planning, conferencesfitness💪Training programs, workout plansstrategy📊Business strategy, OKRscourse📖Curricula, lesson plansfilm🎬AI video production (Sora, Veo)veo3🎥Google Veo 3 workflowssora2🎬OpenAI Sora 2 workflowsphilosophy🤔Philosophical arguments, dialoguesprompting🧠Prompt engineering librariesfamilytree👨‍👩‍👧‍👦Genealogy, family historydialogue💬Debate analysis, rhetoricfilesystem💾File/folder organizationgmail📧Email workflowsknowledge-base📚Document corpora, RAG prepcapex💰Capital expenditure, investor pitchesfreespeech🎙️Voice capture pattern analysislifetree🌳Biographical timelinescustom✏️Define your own level names

### patterns — Discover available patterns

# List all patterns
node scripts/treelisty-cli.js patterns

# Get details for a specific pattern
node scripts/treelisty-cli.js patterns --name philosophy

# Get full JSON schema
node scripts/treelisty-cli.js patterns --name philosophy --detail

### decompose — Create structured trees

Takes text input (topic, outline, or structured text) and applies a pattern template.

# Simple topic
node scripts/treelisty-cli.js decompose \\
  --pattern roadmap \\
  --input "Q1 Product Roadmap for AI Assistant" \\
  --format json

# From structured input (markdown headers, indented lists)
echo "# Marketing Campaign
## Research Phase
- Market analysis
- Competitor review
## Execution Phase
- Content creation
- Launch ads" | node scripts/treelisty-cli.js decompose --pattern strategy --format json

# Output as Mermaid
node scripts/treelisty-cli.js decompose \\
  --pattern wbs \\
  --input "Website Redesign Project" \\
  --format mermaid

Options:

--pattern <key> — Pattern to apply (default: generic)
--input <text|file> — Topic text, file path, or stdin
--name <name> — Override root node name
--depth <1-4> — Maximum tree depth
--format <fmt> — Output: json, markdown, mermaid

### export — Convert trees to other formats

# To Markdown
node scripts/treelisty-cli.js export --input tree.json --format markdown

# To Mermaid diagram
node scripts/treelisty-cli.js export --input tree.json --format mermaid

# To CSV
node scripts/treelisty-cli.js export --input tree.json --format csv

# To checklist
node scripts/treelisty-cli.js export --input tree.json --format checklist

Formats: json, markdown, mermaid, csv, checklist, html

### validate — Check tree quality

# Human-readable report
node scripts/treelisty-cli.js validate --input tree.json

# JSON report
node scripts/treelisty-cli.js validate --input tree.json --format json

Returns:

Quality score (0-100)
Structure analysis (node counts, depth, balance)
Issues (errors, warnings, suggestions)
Pattern compliance check

### push — Send to live TreeListy (optional)

If the user has TreeListy open in their browser with MCP bridge enabled:

node scripts/treelisty-cli.js push \\
  --input tree.json \\
  --port 3456

This displays the tree in TreeListy's visual canvas for interactive exploration.

### Tree Data Model

Trees follow this structure:

{
  "id": "n_abc12345",
  "treeId": "tree_xyz78901",
  "name": "Project Name",
  "type": "root",
  "pattern": "roadmap",
  "icon": "🚀",
  "description": "Optional description",
  "expanded": true,
  "children": [
    {
      "name": "Phase 1",
      "type": "phase",
      "items": [
        {
          "name": "Feature A",
          "type": "item",
          "patternType": "Core Feature",
          "subtasks": [
            {
              "name": "Implement login",
              "type": "subtask"
            }
          ]
        }
      ]
    }
  ]
}

Hierarchy: Root → Phases (children) → Items (items) → Subtasks (subtasks)

Each pattern adds custom fields. For example, roadmap adds storyPoints, userImpact, technicalRisk.

### Workflow Example

Agent receives complex task from user


Decompose with appropriate pattern:
node scripts/treelisty-cli.js decompose \\
  --pattern wbs \\
  --input "Build an e-commerce platform with user auth, product catalog, shopping cart, and checkout" \\
  --format json > project.json



Validate the structure:
node scripts/treelisty-cli.js validate --input project.json



Export for user consumption:
node scripts/treelisty-cli.js export --input project.json --format mermaid



Share the Mermaid diagram in response to user.

### No AI Tokens Used

All TreeListy operations are local pattern transformations. Zero API calls, zero token cost. The skill structures your content using 21 battle-tested hierarchical templates.

### Learn More

Full pattern reference: references/PATTERNS.md
TreeListy visual app: https://treelisty.com
Source: https://github.com/prairie2cloud/treelisty
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Prairie2Cloud
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/treelisty-openclaw-skill)
- [Send to Agent page](https://openagent3.xyz/skills/treelisty-openclaw-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/treelisty-openclaw-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/treelisty-openclaw-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/treelisty-openclaw-skill)