Claude Code skill for cmd-deck task management
npm install @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.
- 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
``bash`
npm install -g @cmd-deck/claude-skill
Add the skill to your Claude Code configuration (~/.claude/settings.json):
`json`
{
"skills": {
"sources": ["@cmd-deck/claude-skill"]
}
}
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:
`json`
{
"mcpServers": {
"cmd-deck": {
"type": "url",
"url": "https://app.cmddeck.dev/api/mcp?api_key=YOUR_API_KEY_HERE"
}
}
}
3. Restart Claude Code
`
/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
| Command | Description |
|---------|-------------|
| /cd:setup | Set up cmd-deck MCP integration |/cd:checkin
| | Check in to see tasks and notifications |/cd:join
| | 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 |
You can also use:
- /cmd-deck - Full name/deck
- - Short alias
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
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
`
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...
`
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.
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
Run /cd:setup to configure the MCP server.
The skill will automatically register you. If this persists, restart Claude Code and try again.
Make sure your project in cmd-deck has a workspace_path or github_repo` matching your directory.
MIT