List Projects Skill

List Projects Skill

List all available projects in the Conductor workspace.

Overview

This skill scans the projects/ directory and displays all initialized projects with their current status.

Usage

/​list-projects

Prerequisites

• Access to the projects/ directory and SurrealDB connection for status.

Outputs

• A table of projects with phase/​status metadata.

Output Format

# Available Projects

| Project | Phase | Status | Last Updated |
|---------|-------|--------|--------------|
| my-feature | 3 - Implementation | 40% complete | 2026-01-22 |
| auth-system | 5 - Completion | Done | 2026-01-21 |
| api-refactor | 2 - Validation | Awaiting review | 2026-01-20 |

## Project Details

### my-feature
- **Path**: projects/​my-feature/
- **Current Phase**: 3 - Implementation
- **Tasks**: 2/​5 completed
- **Has PRODUCT.md**: Yes
- **Has Documents/​**: Yes

### auth-system
- **Path**: projects/​auth-system/
- **Current Phase**: 5 - Completion
- **Status**: Workflow complete
- **Has PRODUCT.md**: Yes

### api-refactor
- **Path**: projects/​api-refactor/
- **Current Phase**: 2 - Validation
- **Status**: Awaiting Cursor/​Gemini approval
- **Has PRODUCT.md**: Yes

Discovery Logic

# Find all projects
ls -d projects/​*/

# For each project, check:
# 1. Has a workflow state entry in SurrealDB?
# 2. Has PRODUCT.md?
# 3. Has Documents/?

Project Validation

A valid project has:

• Directory exists in projects/
• Contains PRODUCT.md (required for workflow)
• Uses SurrealDB for workflow state (created on first run)

Status Indicators

Integration

Called by:

• User directly
• /​orchestrate - To select a project
• Shell script: ./​scripts/​init.sh list

Example Discovery

# List project directories
for dir in projects/​*/; do
    project_name=$(basename "$dir")

    # Check for state in DB (pseudo)
    if surrealdb_has_state "$project_name"; then
        phase=$(surrealdb_get_phase "$project_name")
        echo "$project_name: Phase $phase"
    elif [ -f "$dir/​PRODUCT.md" ]; then
        echo "$project_name: Not started"
    else
        echo "$project_name: Missing PRODUCT.md"
    fi
done

Error Handling

• If SurrealDB is unreachable, list projects without phase data and warn.
• If projects/ is missing, return an empty result with a clear error.

Related Skills

• /​status - Project workflow status
• /​phase-status - Detailed phase status for a project