Clawhub-skills jooto-agent

Task and project management on Jooto — create tasks, manage boards, automate workflows via PR TIMES' tool

install

source · Clone the upstream repo

git clone https://github.com/traygerbig/clawhub-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/traygerbig/clawhub-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/business-ops-pack/jooto-agent" ~/.claude/skills/traygerbig-clawhub-skills-jooto-agent && rm -rf "$T"

manifest: business-ops-pack/jooto-agent/SKILL.md

source content

       ╔═══════════════════════════════════════════════════════╗
       ║        ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓        ║
       ║        ┃   ╦╔═╗╔═╗╔╦╗╔═╗                   ┃        ║
       ║        ┃   ║║ ║║ ║ ║ ║ ║                   ┃        ║
       ║        ┃  ╚╝╚═╝╚═╝ ╩ ╚═╝                   ┃        ║
       ║        ┃      A G E N T                     ┃        ║
       ║        ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛        ║
       ║                                                       ║
       ║   [ TODO ]──>[ IN PROGRESS ]──>[ REVIEW ]──>[ DONE ] ║
       ║     ┃             ┃               ┃           ┃      ║
       ║     ▼             ▼               ▼           ▼      ║
       ║   ┌───┐       ┌───┐           ┌───┐       ┌───┐     ║
       ║   │ 5 │       │ 3 │           │ 2 │       │12 │     ║
       ║   └───┘       └───┘           └───┘       └───┘     ║
       ╚═══════════════════════════════════════════════════════╝

skill: jooto-agent

version: 1.0.0

platform: Jooto API v1

tasks: unlimited

boards: multi-project

Command your entire Jooto workspace from the terminal -- create tasks, orchestrate boards, and automate team workflows without ever opening a browser.

Overview

Jooto Agent transforms your CLI into a full-featured Jooto project management cockpit. Jooto, developed by PR TIMES (a leading Japanese PR and communications platform), is one of Japan's most popular kanban-style task management tools, trusted by over 1,800 organizations including agencies, startups, and enterprise teams. This skill bridges the gap between developer workflows and project management by bringing every Jooto capability directly into your terminal session.

With Jooto Agent, you can create and manage tasks across multiple boards, assign team members, set priorities and due dates, attach files, and generate progress reports -- all through intuitive CLI commands. The skill supports advanced workflows including recurring task automation, bulk operations, label-based filtering, and cross-board analytics. Whether you are running a sprint for a software team in Tokyo or coordinating a marketing campaign across distributed offices, Jooto Agent keeps your project data at your fingertips without context-switching.

  Architecture Overview
  =====================

  ┌─────────────┐     ┌──────────────────┐     ┌─────────────────┐
  │  Developer   │     │   Jooto Agent    │     │   Jooto API     │
  │  Terminal    │────>│   CLI Layer      │────>│   (PR TIMES)    │
  │             │     │                  │     │                 │
  │  jo tasks   │     │  ┌────────────┐  │     │  ┌───────────┐  │
  │  jo create  │     │  │ Auth Mgr   │  │     │  │ Boards    │  │
  │  jo boards  │     │  ├────────────┤  │     │  │ Tasks     │  │
  │  jo report  │     │  │ Cmd Router │  │     │  │ Users     │  │
  │             │     │  ├────────────┤  │     │  │ Labels    │  │
  └─────────────┘     │  │ Formatter  │  │     │  │ Comments  │  │
                      │  └────────────┘  │     │  └───────────┘  │
                      └──────────────────┘     └─────────────────┘
                               │
                      ┌────────▼────────┐
                      │  Local Cache    │
                      │  ~/.jooto/      │
                      │  - boards.json  │
                      │  - config.yaml  │
                      └─────────────────┘

System Prompt Instructions

You are the Jooto Agent, an expert project management assistant specialized in Jooto (PR TIMES). Follow these rules precisely:

Always authenticate using the
```
JOOTO_API_KEY
```
environment variable before making any API calls. If the key is missing, prompt the user to set it and provide the URL for Jooto API key generation.
Default to the organization specified by
```
JOOTO_ORGANIZATION_ID
```
. If not set, fetch and cache the user's primary organization on first run.
When creating tasks, require at minimum a title and board ID. Infer the board from context if the user has only one active board.
Always display task status using kanban-style labels:
```
[TODO]
```
,
```
[IN PROGRESS]
```
,
```
[REVIEW]
```
,
```
[DONE]
```
. Map these to Jooto's internal list IDs automatically.
Format all dates in
```
YYYY-MM-DD
```
format for consistency. When the user says "tomorrow" or "next Friday," calculate the absolute date from the current system date.
When listing tasks, default to showing the current user's assigned tasks sorted by due date. Support
```
--all
```
flag to show all board tasks.
Support Japanese task titles and descriptions natively. Output headers in English but preserve Japanese content as-is.
For recurring tasks, validate the cron expression or natural-language interval before scheduling. Supported intervals: daily, weekly, biweekly, monthly, quarterly.
When attaching files, verify the file exists locally before uploading. Enforce a 10MB file size limit per Jooto API constraints.
Rate-limit API calls to a maximum of 60 requests per minute. Queue excess requests and notify the user of estimated wait time.
Cache board metadata locally in
```
~/.jooto/boards.json
```
with a 5-minute TTL. Force refresh with
```
--refresh
```
flag.
For
```
jo report
```
, aggregate task counts by status, assignee, and label. Calculate completion percentages and velocity metrics over the specified time range.
When updating tasks, confirm destructive changes (deletion, status regression) with the user before executing. Use
```
--force
```
to skip confirmation.
Color-code priority levels in terminal output:
```
[P1]
```
red,
```
[P2]
```
yellow,
```
[P3]
```
green,
```
[P4]
```
gray. Fall back to text labels if the terminal does not support colors.
On any API error, display the HTTP status code, Jooto error message, and a suggested remediation action. Retry transient errors (429, 500, 502, 503) up to 3 times with exponential backoff.
When managing team members, respect Jooto role permissions. Do not attempt admin-only operations unless the authenticated user has admin privileges.
For export operations, support CSV, JSON, and Markdown formats. Default to CSV if no format is specified.
Log all write operations (create, update, delete) to
```
~/.jooto/audit.log
```
with timestamps for traceability.

Environment Variables

Variable	Required	Default	Description
`JOOTO_API_KEY`	Yes	--	API key from Jooto account settings
`JOOTO_ORGANIZATION_ID`	No	auto-detect	Organization ID for multi-org accounts
`JOOTO_DEFAULT_BOARD`	No	--	Default board ID for task operations
`JOOTO_CACHE_TTL`	No	`300`	Cache time-to-live in seconds
`JOOTO_LOG_LEVEL`	No	`info`	Logging verbosity: debug, info, warn, error
`JOOTO_LOCALE`	No	`ja`	Output locale (ja, en)

Commands

jo tasks

-- List Tasks

$ jo tasks
┌─────────────────────────────────────────────────────────────────────┐
│  Board: Website Redesign (board-4821)                              │
├──────┬──────────────────────────┬────────┬──────────┬──────────────┤
│  ID  │  Title                   │ Status │ Priority │ Due Date     │
├──────┼──────────────────────────┼────────┼──────────┼──────────────┤
│ 1042 │ Design hero section      │ [DONE] │   [P1]   │ 2026-02-28   │
│ 1043 │ Implement nav component  │ [IP]   │   [P1]   │ 2026-03-03   │
│ 1044 │ Write product copy       │ [TODO] │   [P2]   │ 2026-03-05   │
│ 1045 │ QA responsive layout     │ [TODO] │   [P2]   │ 2026-03-07   │
│ 1046 │ Deploy staging           │ [TODO] │   [P3]   │ 2026-03-10   │
└──────┴──────────────────────────┴────────┴──────────┴──────────────┘
  Showing 5 tasks assigned to you | Total on board: 23

jo create

-- Create a Task

$ jo create --board 4821 --title "Add footer links" --priority P2 --due 2026-03-08 --assign tanaka
Task created successfully.
  ID:       1047
  Board:    Website Redesign (board-4821)
  Title:    Add footer links
  Priority: [P2]
  Due:      2026-03-08
  Assignee: Tanaka Yuki (@tanaka)
  Status:   [TODO]

jo boards

-- List Boards

$ jo boards
┌────────┬────────────────────────┬────────┬───────────┬─────────────┐
│  ID    │  Name                  │ Tasks  │ Members   │ Updated     │
├────────┼────────────────────────┼────────┼───────────┼─────────────┤
│  4821  │ Website Redesign       │   23   │    5      │ 2026-03-01  │
│  4805  │ Q1 Marketing Campaign  │   47   │    8      │ 2026-02-28  │
│  4799  │ Mobile App Sprint 3    │   31   │    4      │ 2026-02-27  │
│  4788  │ Internal Tools         │   12   │    3      │ 2026-02-25  │
└────────┴────────────────────────┴────────┴───────────┴─────────────┘
  4 boards in organization: ClawHub Inc.

jo update

-- Update a Task

$ jo update 1043 --status done --comment "Navigation merged in PR #287"
Task #1043 updated.
  Title:    Implement nav component
  Status:   [IN PROGRESS] -> [DONE]
  Comment:  "Navigation merged in PR #287" added.
  Updated:  2026-03-01 14:32:05 JST

jo comments

-- View or Add Comments

$ jo comments 1043
Task #1043: Implement nav component
───────────────────────────────────────
  [2026-02-27 09:15] @suzuki:
    Started working on this. Using shadcn/ui for base components.

  [2026-02-28 16:42] @tanaka:
    Looks good. Please add mobile hamburger menu too.

  [2026-03-01 14:32] @ishihara:
    Navigation merged in PR #287

  3 comments total

jo labels

-- Manage Labels

$ jo labels --board 4821
┌────────┬──────────────────┬─────────┬────────────┐
│  ID    │  Label           │ Color   │ Task Count │
├────────┼──────────────────┼─────────┼────────────┤
│  L01   │  Bug             │  red    │     4      │
│  L02   │  Feature         │  blue   │    11      │
│  L03   │  Design          │  purple │     5      │
│  L04   │  Documentation   │  gray   │     3      │
└────────┴──────────────────┴─────────┴────────────┘

$ jo labels create --board 4821 --name "Urgent" --color red
Label "Urgent" (L05) created on board Website Redesign.

jo recurring

-- Manage Recurring Tasks

$ jo recurring create --board 4821 --title "Weekly standup notes" --interval weekly --day monday --assign team
Recurring task created.
  ID:       R-0012
  Title:    Weekly standup notes
  Board:    Website Redesign
  Schedule: Every Monday
  Assignee: All team members
  Next:     2026-03-02 (Monday)

$ jo recurring list
┌────────┬──────────────────────────┬───────────┬─────────────┐
│  ID    │  Title                   │ Interval  │ Next Run    │
├────────┼──────────────────────────┼───────────┼─────────────┤
│ R-0010 │ Monthly retrospective    │ monthly   │ 2026-03-31  │
│ R-0011 │ Daily bug triage         │ daily     │ 2026-03-02  │
│ R-0012 │ Weekly standup notes     │ weekly    │ 2026-03-02  │
└────────┴──────────────────────────┴───────────┴─────────────┘

jo report

-- Generate Reports

$ jo report --board 4821 --period 2026-02
Board: Website Redesign | Period: February 2026
════════════════════════════════════════════════
  Status Breakdown:
    [DONE]        ████████████████░░░░  12 (52%)
    [IN PROGRESS] ████░░░░░░░░░░░░░░░░   4 (17%)
    [REVIEW]      ███░░░░░░░░░░░░░░░░░   2  (9%)
    [TODO]        █████░░░░░░░░░░░░░░░   5 (22%)

  Team Velocity:
    @tanaka     8 tasks completed   (top performer)
    @suzuki     5 tasks completed
    @ishihara   3 tasks completed

  Overdue: 1 task (#1039 - missed deadline 2026-02-25)
  Avg completion time: 3.2 days

jo export

-- Export Board Data

$ jo export --board 4821 --format csv --output ./tasks.csv
Exporting board "Website Redesign"...
  Tasks exported:  23
  Format:          CSV
  Output:          ./tasks.csv
  Size:            4.2 KB
Export complete.

jo team

-- Manage Team Members

$ jo team --board 4821
┌──────────────┬───────────────────┬──────────┬──────────────┐
│  Username    │  Name             │ Role     │ Active Tasks │
├──────────────┼───────────────────┼──────────┼──────────────┤
│  @ishihara   │  Ishihara Tatsuya │  Admin   │      3       │
│  @tanaka     │  Tanaka Yuki      │  Member  │      6       │
│  @suzuki     │  Suzuki Aoi       │  Member  │      4       │
│  @yamamoto   │  Yamamoto Ken     │  Member  │      2       │
│  @sato       │  Sato Mika        │  Viewer  │      0       │
└──────────────┴───────────────────┴──────────┴──────────────┘
  5 members | Board: Website Redesign

Workflow Diagram

  Task Lifecycle in Jooto Agent
  ═════════════════════════════

  ┌──────────┐    jo create    ┌──────────┐    jo update     ┌──────────┐
  │          │ ──────────────> │          │ ───────────────> │          │
  │  INBOX   │                 │   TODO   │                  │    IP    │
  │          │                 │          │ <─── jo update   │          │
  └──────────┘                 └──────────┘    (revert)      └──────────┘
                                                                  │
                                                    jo update     │
                                                  ┌───────────────┘
                                                  ▼
  ┌──────────┐   jo update     ┌──────────┐
  │          │ <────────────── │          │
  │   DONE   │                 │  REVIEW  │
  │          │                 │          │
  └──────────┘                 └──────────┘
       │
       ▼
  ┌──────────────────┐
  │  jo report       │──> Analytics & Metrics
  │  jo export       │──> CSV / JSON / Markdown
  └──────────────────┘

  Recurring Tasks:
  ┌────────────┐    cron/interval    ┌──────────┐
  │ jo recurring│ ─────────────────> │ Auto-    │──> TODO list
  │   create    │                    │ generate │
  └────────────┘                     └──────────┘

Error Handling

Error	Cause	Solution
`AUTH_001: Invalid API key`	The `JOOTO_API_KEY` is expired or incorrect.	Regenerate your API key at Jooto Settings > API and update the environment variable.
`BOARD_404: Board not found`	The specified board ID does not exist or you lack access.	Run `jo boards` to list accessible boards. Verify the ID and your membership.
`RATE_429: Too many requests`	API rate limit of 60 requests/minute exceeded.	Wait 60 seconds or reduce batch size. The agent auto-retries with backoff.
`TASK_CONFLICT: Duplicate title`	A task with the same title already exists on the board in the same list.	Use `--allow-duplicate` flag or rename the task.
`FILE_TOO_LARGE: Exceeds 10MB`	Attachment file exceeds Jooto's upload limit.	Compress the file or host it externally and add a link in the task description.
`PERM_403: Insufficient privileges`	Your role (Member/Viewer) cannot perform admin operations like deleting boards.	Contact your organization admin to elevate your role, or use an admin API key.
`NET_TIMEOUT: Connection timeout`	Network issue or Jooto service is temporarily unavailable.	Check your internet connection. The agent retries up to 3 times automatically.

FAQ

1. How do I get a Jooto API key? Log in to Jooto, go to Settings > API Integration, and generate a new key. Copy it to your

JOOTO_API_KEY

environment variable.

2. Can I manage multiple organizations? Yes. Set

JOOTO_ORGANIZATION_ID

to switch between organizations, or use

--org <id>

on any command.

3. Does Jooto Agent work with Jooto's free plan? Yes. All core task and board operations work on the free plan. Some advanced features like file attachments may be limited by your plan.

4. How do recurring tasks work? The agent uses Jooto's API scheduling or, if unavailable, creates a local cron job that generates tasks at the specified interval.

5. Can I use Japanese in task titles? Absolutely. The agent fully supports UTF-8 including Japanese, Chinese, and emoji characters in titles and descriptions.

6. Is there an offline mode? The agent caches recent board data locally. You can view cached tasks offline, but creating or updating tasks requires an active connection.

7. How do I filter tasks by label? Use

jo tasks --label Bug

jo tasks --label L01

to filter by label name or ID.

8. Can I bulk-create tasks from a CSV? Yes. Use

jo create --from-csv tasks.csv

where the CSV has columns: title, priority, due_date, assignee.

9. How does the report calculate velocity? Velocity is measured as tasks moved to DONE per week, averaged over the specified reporting period.

10. Does it integrate with GitHub or Slack? Jooto Agent focuses on Jooto's API. For GitHub integration, pair it with other ClawHub skills. Jooto's native Slack integration works independently.

11. What happens if I delete a task by accident? Deleted tasks are soft-deleted in Jooto for 30 days. Contact Jooto support or check the trash in the web UI to restore.

12. Can I customize the kanban columns? The agent maps to Jooto's list structure. Create custom lists in Jooto's web UI, and the agent will recognize them automatically.

Data Storage

~/.jooto/
├── config/
│   └── config.yaml
├── cache/
│   ├── boards.json
│   └── members.json
├── exports/
│   ├── csv/
│   ├── json/
│   └── markdown/
├── recurring/
│   └── schedules.json
└── logs/
    └── audit.log

All data is stored locally on disk. No data is sent to third-party services beyond the official Jooto API. API keys are stored in plaintext in the config file; for enhanced security, use environment variables instead.

Comparison Table

Feature	Jooto Agent (CLI)	Jooto Web UI	Trello CLI	Asana CLI
Task CRUD	Full	Full	Full	Full
Bulk operations	Yes (CSV import)	Limited	No	Yes
Offline viewing	Yes (cache)	No	No	No
Japanese-native	Yes	Yes	No	No
Recurring tasks	Yes	Web only	No	Yes
CLI reports	Bar charts + metrics	Dashboard	No	Basic
Export formats	CSV, JSON, MD	CSV	JSON	CSV
PR TIMES ecosystem	Native	Native	No	No
Team management	Yes	Yes	Limited	Yes
Custom workflows	Label + priority	Drag-drop	Power-ups	Rules
Price	Free (OSS)	Freemium	Free	Paid
Setup time	2 minutes	Browser login	5 minutes	10 minutes

Jooto Agent -- because your kanban board belongs in your terminal, not your browser tab.

Clawhub-skills jooto-agent

Overview

System Prompt Instructions

Environment Variables

Commands

`jo tasks`
-- List Tasks

`jo create`
-- Create a Task

`jo boards`
-- List Boards

`jo update`
-- Update a Task

`jo comments`
-- View or Add Comments

`jo labels`
-- Manage Labels

`jo recurring`
-- Manage Recurring Tasks

`jo report`
-- Generate Reports

`jo export`
-- Export Board Data

`jo team`
-- Manage Team Members

Workflow Diagram

Error Handling

FAQ

Data Storage

Comparison Table