# Send Project Router to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "project-router",
    "name": "Project Router",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/SafaTinaztepe/project-router",
    "canonicalUrl": "https://clawhub.ai/SafaTinaztepe/project-router",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/project-router",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-router",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/project.js",
      "scripts/server.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "project-router",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T23:47:34.930Z",
      "expiresAt": "2026-05-07T23:47:34.930Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-router",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-router",
        "contentDisposition": "attachment; filename=\"project-router-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "project-router"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/project-router"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/project-router",
    "downloadUrl": "https://openagent3.xyz/downloads/project-router",
    "agentUrl": "https://openagent3.xyz/skills/project-router/agent",
    "manifestUrl": "https://openagent3.xyz/skills/project-router/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/project-router/agent.md"
  }
}
```
## Documentation

### project-router

This skill is Safa’s canonical project management + context switching control plane.

Core idea:

Canonical PM is local + queryable (SQLite): projects, tasks, context packs.
Trello is a tracking backend/UI: cards mirror canonical tasks; lists mirror status; labels mirror priority.
The “killer feature” is context switching: load the right docs/code/index for a project/task quickly and deterministically.

It provides:

CLI: project <verb> ...
MCP server: mcp-project-router (tools mirror the CLI)
Per-project bundle stored in .project/ (brief, targets, artifact index)
A canonical task store (SQLite) + Trello sync adapter

### Project bundle layout (v1)

The .project/ bundle is the project-local context nucleus. The canonical PM DB points at these bundles.

Inside a project root:

.project/project.json — structured manifest
.project/PROJECT.md — living brief
.project/targets.json — target definitions (commands)
.project/index/artifacts.json — artifact index
.project/history/plans/*.json — plans
.project/history/applies/*.json — apply receipts

### Baseline / existing commands

From anywhere inside a repo/workspace:

project detect
project context
project target list
project target run <name>

Initialize a bundle (dry-run plan + apply):

project init (prints plan)
project apply <planId>

Artifacts:

project artifact add <path|url> [--tags a,b,c] (plan + apply)

### Canonical PM + context switching (new)

Note: these verbs are the target UX. Implementations should remain idempotent and safe.

Project registration:

project pm project add <slug> --name "..." --root <path>
project pm project list

Task management:

project pm task add <slug> "<title>" --priority P0|P1|P2|P3 [--status inbox|next|doing|blocked|waiting|done]
project pm task list [--project <slug>] [--status ...]
project pm task set-status <taskId> <status>

Context switching:

project pm switch <slug>

prints pinned docs + top targets + active tasks


project pm focus <taskId>

loads task-linked files/artifacts and updates the task activity log

Trello sync:

project pm trello sync [--project <slug>]

ensures the single "Safa — PM" Trello board exists
ensures lists exist (Inbox/Next/Doing/Blocked/Waiting/Done)
upserts cards for canonical tasks
moves cards to match status
applies priority labels (P0..P3)

### MCP quick start (via mcporter)

mcporter list mcp-project-router --schema --timeout 120000 --json

Examples:

Detect:

mcporter call --server mcp-project-router --tool project_detect --args '{}'


Read context:

mcporter call --server mcp-project-router --tool project_context_read --args '{}'


Run target:

mcporter call --server mcp-project-router --tool project_target_run --args '{"target":"test"}'

### Trello backend conventions

Single-board setup:

Board name: Safa — PM (or configurable)
Lists == canonical statuses:

Inbox, Next, Doing, Blocked, Waiting, Done


Card title: [<project_slug>] <task_title>
Card description begins with a machine block for idempotency:
--- pm ---
task_id: <stable-id>
project: <slug>
status: <status>
priority: P0|P1|P2|P3
---


Labels (priority, color-coded):

P0 = red
P1 = orange
P2 = yellow
P3 = blue

### Canonical PM storage (SQLite)

Recommended DB location (in workspace):

/home/safa/clawd/data/pm/pm.sqlite

Minimum tables (v0):

projects(slug PRIMARY KEY, name, root_path, created_at, updated_at)
tasks(task_id PRIMARY KEY, project_slug, title, status, priority, created_at, updated_at)
task_refs(task_id, kind, ref) (file paths / urls / artifacts)
external_refs(task_id, system, external_id, meta_json) (e.g., Trello card_id/list_id)

### Safety

Project bundle writes remain plan/apply.
Canonical PM writes should be idempotent and auditable (timestamps + activity log).
Trello sync should be safe to re-run repeatedly (upsert by task_id marker; never duplicate cards).
project_target_run executes commands defined in .project/targets.json.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: SafaTinaztepe
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T23:47:34.930Z
- Expires at: 2026-05-07T23:47:34.930Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/project-router)
- [Send to Agent page](https://openagent3.xyz/skills/project-router/agent)
- [JSON manifest](https://openagent3.xyz/skills/project-router/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/project-router/agent.md)
- [Download page](https://openagent3.xyz/downloads/project-router)