---
name: gsd-openclaw
description: GSD project management via /gsd:* commands. Triggers on /gsd:new-project, /gsd:plan, /gsd:status, /gsd:use and other GSD slash commands.
---

# GSD-OpenClaw Skill

This skill enables GSD (Get Shit Done) project management through chat interfaces via OpenClaw.

## How It Works

This skill uses the `Orchestrator` class from `orchestrator.py` as its main entry point. When a user sends a message starting with `/gsd:`:

1. **Command Parsing**: The orchestrator parses the `/gsd:*` pattern to extract the command and arguments
2. **Session Management**: Auto-creates a tmux session if one doesn't exist for the project
3. **Command Execution**: Executes the GSD command via the tmux session
4. **Response Formatting**: Returns a formatted Feishu card with the result

For interactive operations that require user confirmation (e.g., approvals), the orchestrator:
- Detects approval requests in Claude CLI output
- Returns an interactive card with confirm/reject buttons
- Handles button callbacks to continue or cancel the operation

## When to Use

This skill triggers when users send messages starting with `/gsd:` in any channel where OpenClaw is configured. Use this skill to:

- Create and manage GSD projects
- Switch between project contexts
- Check project status
- Execute planning and shipping workflows

## Commands

| Command | Description |
|---------|-------------|
| `/gsd:new-project <name>` | Create a new GSD project |
| `/gsd:use <project>` | Switch to a project context |
| `/gsd:status` | Show current project status |
| `/gsd:plan` | Run planning phase |
| `/gsd:ship` | Ship the current phase |
| `/gsd:help` | Show available commands |

## Project Context

GSD manages multiple projects, each with its own workspace and state. Use `/gsd:use <project>` to switch the active project context before running other commands.

Example:
```
/gsd:new-project my-auth-service
/gsd:use my-auth-service
/gsd:status
```

## Integration Notes

- Sessions persist in tmux for long-running operations
- State is checkpointed to JSON for recovery
- Multiple projects can run concurrently without interference