# Tasks Router

> Routes task operations to tasks-file or tasks-beads based on project state. Use when a skill needs to create, triage, or update tasks and must choose the system.

- Skill: `majiayu000/tasks-router` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/tasks-router`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/tasks-router/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/tasks-router

---


# Tasks Router Skill

## Overview

Use this skill to select the correct task system for the current repository and then follow the chosen skill.

## Routing Logic

- If `.beads/` exists at repo root, use `tasks-beads`.
- Otherwise, use `tasks-file`.
- If `.beads/` exists but `br` is not available, fall back to `tasks-file` and note the mismatch.

## Procedure

1. Check for Beads workspace:
   ```bash
   test -d .beads
   ```
2. If `.beads/` exists, verify `br` is installed:
   ```bash
   command -v br
   ```
3. State the selected skill explicitly:
   - "Using tasks-beads" or "Using tasks-file"
4. Follow the chosen skill's workflow.

## Examples

**Beads project:**
```bash
test -d .beads
command -v br
# Using tasks-beads
br create --title="..." --type=bug --priority=2 --description="..." --json
```

**File-based project:**
```bash
test -d .beads || echo "no beads"
# Using tasks-file
create tasks/001-pending-p2-short-title.md using the tasks-file workflow
```