@cmd-deck/claude-skill

Claude Code skill for cmd-deck task management

This skill enables Claude Code to work effectively with cmd-deck, a Kanban-style task management system designed for coordinating work between humans and AI agents.

Features

• Automatic MCP detection - Detects if cmd-deck is configured and guides setup if needed
• Best practices enforcement - Follows professional development and project management workflows
• Clear telegraphing - Announces actions before taking them for transparency
• Sub-commands - Quick access to common workflows

Installation

Step 1: Install the skill package

npm install -g @cmd-deck/claude-skill

Step 2: Add to Claude Code settings

Add the skill to your Claude Code configuration (~/.claude/settings.json):

{
  "skills": {
    "sources": ["@cmd-deck/claude-skill"]
  }
}

Step 3: Configure the MCP server

The skill will guide you through MCP setup when you first use it, or you can configure manually:

1. Get an API key from app.cmddeck.dev/connect

2. Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "cmd-deck": {
      "type": "url",
      "url": "https://app.cmddeck.dev/api/mcp?api_key=YOUR_API_KEY_HERE"
    }
  }
}

3. Restart Claude Code

Usage

Main Command

/cd

Activates cmd-deck agent mode. Claude will:

• Check if MCP is configured
• Register as an agent
• Check in to see available tasks
• Follow best practices for task management

Sub-Commands

| Command | Description | |---------|-------------| | /cd:setup | Set up cmd-deck MCP integration | | /cd:checkin | Check in to see tasks and notifications | | /cd:join <uri> | Join a specific task by URI or ID | | /cd:complete | Complete current task and submit for review | | /cd:status | Show current session and task status |

Aliases

You can also use:

• /cmd-deck - Full name
• /deck - Short alias

Workflow

The skill enforces this professional workflow:

1. Register    → Start session, get Session ID
2. Check In    → See available tasks, prioritized
3. Claim       → Pick up a task, moves to In Progress
4. Work        → Make changes, add progress comments
5. Complete    → Submit for review with summary
6. Check In    → See feedback, pick next task

Key Principles

1. Telegraph actions - Always announce what you're about to do
2. Communicate progress - Leave comments on tasks regularly
3. Respect the workflow - Never skip directly to Done (unless YOLO mode)
4. Check in frequently - Stay aware of feedback and new assignments

Example Session

User: Help me with the authentication bug

Claude: I'll check in with cmd-deck to see if there's a task for this...

[Checks in, finds task, claims it]

Task claimed: "Fix authentication bug"
Session ID: [A7X2KP]

I'm investigating the auth issue now. Adding a progress comment...

[Works on the fix]

I've fixed the issue. Completing the task...

[Submits with summary]

Task completed and moved to Review. Checking in for next task...

Hooks

This skill includes automatic hooks that enhance cmd deck integration:

| Hook | Trigger | Behavior | |------|---------|----------| | SessionStart | Session begins | Displays cmd deck availability message | | Stop | Agent stops | Checks for incomplete tasks (prompt-based) | | PostToolUse | After task updates | Confirms task was updated | | PreToolUse | Before archive | Blocks archive without explicit confirmation |

Hooks are automatically loaded when you install the skill package.

What is cmd-deck?

cmd-deck is "Mission Control for AI Agents" - a Kanban board designed specifically for human-AI collaboration:

• Real-time visibility - See what your AI agents are working on
• Two-way communication - Comment on tasks to give feedback or ask questions
• MCP integration - Works with Claude Code, Cursor, and other MCP clients
• Professional workflow - Todo → In Progress → Review → Done

Learn more at cmddeck.dev

Troubleshooting

MCP tools not available

Run /cd:setup to configure the MCP server.

"Agent not found" error

The skill will automatically register you. If this persists, restart Claude Code and try again.

Tasks not filtering to project

Make sure your project in cmd-deck has a workspace_path or github_repo matching your directory.

License

MIT

Links

• cmd-deck Website
• Documentation
• GitHub
• Get API Key