rad-project

Query and organize project identity, relationships, and worktree locations via the radorch CLI.

Updated May 24, 2026
One-click install
npx skills add https://github.com/MetalHexx/rad-orc-marketplace --skill rad-project-metalhexx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rad-project
Source: https://github.com/MetalHexx/rad-orc-marketplace/tree/main/claude-plugin/skills/rad-project
Command: npx skills add https://github.com/MetalHexx/rad-orc-marketplace --skill rad-project-metalhexx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When working across multiple projects, it is hard to know what projects exist, which are in progress, how they relate to each other, and where their worktrees live on disk. This Skill answers those questions by querying the rad-orc work-graph so you always act in the right place with full project context. ## Core Features & Use Cases - Project orientation: List active projects, show a project's status, tier, worktrees, and relationships, and classify your current directory with project locate. - Relationship management: Organize projects into groups and record follows, depends-on, and spawned-from edges in the work-graph after confirming with the user. - Worktree resolution: Find the correct worktree path for any project before acting, and safely delete projects with preview-first confirmation. - Use Case: A user asks "what projects are in progress and where should I work on the payment refactor?" The Skill lists in_progress projects, shows the payment project's relationships, and returns its resolved worktree path. ## Quick Start Ask the assistant to show which projects are currently in progress and where their worktrees are located.

Frequently Asked Questions about rad-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list active projects with the radorch CLI?▼

Run `project list --status in_progress` via the radorch.mjs script to get all active projects. The command returns a JSON envelope whose `data` field contains the matching projects, which the Skill translates into a plain-language summary.

How do I find the worktree path for a project?▼

Run `project worktrees --id <project-id>` to get resolved paths with repo, branch, and existence checks. Always use the returned path rather than constructing one by hand from the `~/.radorc/worktrees/` layout.

What is the difference between a side-project and a spawned-from edge?▼

A side-project is a project type marking a local-only, single-machine repo effort. A spawned-from edge is a relationship asserting one project branched off another. They are independent: a side-project may or may not carry a spawned-from edge.

Can this Skill create projects or worktrees?▼

No. The Skill is awareness-only for location and organization: it surfaces, groups, and deletes projects on request. Project creation, pipeline execution, and worktree lifecycle belong to other skills such as rad-execute and rad-source-control.

Why must the dashboard be stopped before deleting a project?▼

The dashboard's file watchers hold open handles on project folders, which blocks deletion. Stop it with `/rad-ui-stop`, run `project delete --id <id> --preview` to confirm scope, delete on approval, then restart with `/rad-ui-start`.