project-tree_skill

Overview

This skill generates a visual directory tree for the ~/projects folder and automatically updates MEMORY.md with the result. It shows directory names and markdown files only, hiding code and dependency files. The output includes smart grouping for consecutive numbered items and supports configurable depth.

How this skill works

The script scans the configured root directory (default: ~/projects), collects folders and .md files up to a configurable MAX_DEPTH, and applies smart grouping to collapse numbered sequences into range expressions. It then inserts or replaces the PROJECT_TREE section in MEMORY.md with the generated tree. The script can be run manually or triggered by a session reset hook.

When to use it

• You want a quick visual overview of project organization under ~/projects.
• You need MEMORY.md updated with the current project tree for documentation or search.
• You mention 'project tree', 'tree view', 'folder structure', or 'show me my projects'.
• You are preparing to archive, backup, or audit project directories.

Best practices

• Keep MAX_DEPTH modest (default 3) to avoid overly large trees in MEMORY.md.
• Add common exclusions (node_modules, .git) to EXCLUDE_DIRS to reduce noise.
• Run the script from the workspace root or set ROOT_DIR explicitly for alternate locations.
• Use the provided hook to auto-update on session resets for consistent MEMORY.md state.
• Review grouped ranges before committing if you need individual items listed.

Example use cases

• Generate a concise project overview before handing off work to a teammate.
• Automatically refresh MEMORY.md during daily workflow resets to reflect new projects.
• Create a snapshot of markdown documentation locations for archiving.
• Filter out build artifacts and dependencies while documenting project structure.