How do I install the Clidoro skill?

Run npx skillmds@latest add ahmadawais/clidoro in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Clidoro safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Clidoro?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Clidoro free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Clidoro?

ahmadawais (@ahmadawais) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Clidoro by ahmadawais — Agent Skill

Name: Clidoro
Author: ahmadawais

File contents

Clidoro — Pomodoro Timer CLI

You are an AI agent managing pomodoro sessions via the clidoro CLI. All commands support --json for structured output.

Quick Reference

Check State

clidoro status --flag    # → idle | work | break | paused
clidoro status --json    # Full session details
clidoro list --json      # All tasks with pomodoro counts

Task Management

clidoro add "Task title"          # Returns task ID
clidoro edit <id> "New title"     # Rename task
clidoro list --json               # List all tasks
clidoro done <id>                 # Mark done
clidoro remove <id>               # Delete task

Session Control

clidoro start <taskId>            # Start 25min pomodoro
clidoro start <taskId> --break    # Start break
clidoro start <taskId> --duration 15   # Custom minutes
clidoro pause                     # Pause session
clidoro resume                    # Resume session
clidoro complete                  # Complete early (records actual time)
clidoro cancel                    # Cancel without recording

Stats

clidoro stats --json              # Full stats
clidoro stats --daily --json      # Today
clidoro stats --streak --json     # Current streak
clidoro history --limit 5 --json  # Recent sessions

Config

clidoro config --json                     # View config
clidoro config --set workDuration=30      # 30min work
clidoro config --set autoStartBreak=true  # Auto break

Workflow

Check current state: clidoro status --flag
If idle: start a session with clidoro start <taskId>
If work: wait or complete with clidoro complete
If break: wait or complete the break
If paused: resume with clidoro resume

Key Behaviors

Task IDs are stable numeric integers starting at 1
Sessions track actualDuration — completing early records real time
Every 4th session suggests a long break (15min vs 5min)
--flag returns a single word — ideal for conditionals
--json returns structured JSON — ideal for parsing
State persists in ~/.clidoro/state.json
Cancel removes the session from history; complete preserves it

---name: clidorodescription: Pomodoro timer CLI for managing focus sessions and tasks. Use when the user wants to track work sessions, manage tasks with pomodoro technique, or check productivity stats.---# Clidoro — Pomodoro Timer CLIYou are an AI agent managing pomodoro sessions via the `clidoro` CLI. All commands support `--json` for structured output.## Quick Reference### Check State```bashclidoro status --flag # → idle | work | break | pausedclidoro status --json # Full session detailsclidoro list --json # All tasks with pomodoro counts```### Task Management```bashclidoro add "Task title" # Returns task IDclidoro edit <id> "New title" # Rename taskclidoro list --json # List all tasksclidoro done <id> # Mark doneclidoro remove <id> # Delete task```### Session Control```bashclidoro start <taskId> # Start 25min pomodoroclidoro start <taskId> --break # Start breakclidoro start <taskId> --duration 15 # Custom minutesclidoro pause # Pause sessionclidoro resume # Resume sessionclidoro complete # Complete early (records actual time)clidoro cancel # Cancel without recording```### Stats```bashclidoro stats --json # Full statsclidoro stats --daily --json # Todayclidoro stats --streak --json # Current streakclidoro history --limit 5 --json # Recent sessions```### Config```bashclidoro config --json # View configclidoro config --set workDuration=30 # 30min workclidoro config --set autoStartBreak=true # Auto break```## Workflow1. Check current state: `clidoro status --flag`2. If `idle`: start a session with `clidoro start <taskId>`3. If `work`: wait or complete with `clidoro complete`4. If `break`: wait or complete the break5. If `paused`: resume with `clidoro resume`## Key Behaviors- Task IDs are stable numeric integers starting at 1- Sessions track `actualDuration` — completing early records real time- Every 4th session suggests a long break (15min vs 5min)- `--flag` returns a single word — ideal for conditionals- `--json` returns structured JSON — ideal for parsing- State persists in `~/.clidoro/state.json`- Cancel removes the session from history; complete preserves it

Frequently asked questions

Clidoro