project-tree
Generate a visual directory tree of the ~/projects folder and update MEMORY.md with the result. Use when the user wants to view, update, or generate a project tree structure, or when they mention "project tree", "tree view", "folder structure", or "show me my projects".
Why use this skill?
Easily visualize your projects and maintain clean documentation with the OpenClaw project-tree skill. Features smart grouping and auto-update for MEMORY.md.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/lachlanglasgow/project-treeWhat This Skill Does
The project-tree skill provides an intelligent, automated way to visualize your local development workspace. Instead of manually parsing messy file lists, this utility scans your ~/projects directory to generate a clean, hierarchical view. It is specifically designed for developers, stripping away noise like node_modules or binary files, and focusing only on directories and markdown documentation. A standout feature is its 'smart grouping' logic, which identifies sequential numeric patterns in folder names—such as 'tutorial-1', 'tutorial-2'—and collapses them into a concise summary line (e.g., 'tutorial[1-28]/'). The skill automatically pipes this output directly into your MEMORY.md file, ensuring your project context is always synced and human-readable.
Installation
Installation is streamlined via the ClawHub ecosystem. You can install the skill by running 'clawhub install openclaw/skills/skills/lachlanglasgow/project-tree'. Once the repository is cloned into your workspace, you can trigger the script manually using 'node /clawd/skills/project-tree/scripts/project-tree.js' or the provided '/clawd/scripts/update-tree' wrapper. For a truly "set-it-and-forget-it" experience, you can hook the execution into the system's /reset command by enabling internal hooks in your clawdbot.json and creating a custom hook handler that runs the script automatically whenever you refresh your session.
Use Cases
- Project Onboarding: Quickly visualize the structure of a new project folder when starting a session.
- Documentation Maintenance: Keep your MEMORY.md file accurate as you create new sub-directories or move project folders.
- Workspace Organization: Spot clutter or naming inconsistencies by viewing the collapsed structure of multiple project iterations.
- Quick Navigation: Confirm directory paths before executing heavy scripts in complex sub-projects.
Example Prompts
- "Show me my projects in a tree view so I can see what I'm working on."
- "Update my MEMORY.md with the latest folder structure of my projects."
- "What does my current directory structure look like in ~/projects?"
Tips & Limitations
To customize the output, edit the configuration block in 'project-tree.js'. You can adjust 'MAX_DEPTH' to dive deeper into sub-folders or update 'EXCLUDE_DIRS' to ignore specific build artifacts relevant to your workflow. Note that this skill requires access to the filesystem; ensure your environment permissions allow node.js to read and write to your workspace files. The grouping logic relies on standard numeric naming conventions, so it works best if your folders use consistent numbering schemes.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-lachlanglasgow-project-tree": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, code-execution