# Simple Tasks

> Install a fast local task workflow for single-project planning with `scripts/task.sh` (claim, done, status, reporting) backed by `tasks/TASKS.md` and optional `tasks/details/` notes. Use for lightweight in-progress task coordination, not full team issue tracking.

- Skill: `bg-szy/simple-tasks` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bg-szy/simple-tasks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bg-szy/simple-tasks/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: bg-szy (https://skillmd.com/u/bg-szy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bg-szy/simple-tasks

---


# Simple Tasks

## Overview

Paul Solt
Paul@SuperEasyApps.com
Version: 0.9.8

`simple-tasks` installs a lightweight local task CLI into an existing project.

Design goals:
- Fast local planning and execution.
- Human shorthand task numbers + stable task IDs.
- Single canonical backlog file: `tasks/TASKS.md`.
- Optional long-form notes per task: `tasks/details/<id>.md`.

## Install

```bash
skills/simple-tasks/scripts/install.sh --project-dir /path/to/project
```

Common flags:
- `--project-dir PATH` required
- `--mode install|upgrade` default `install`
- `--dry-run` preview changes only

## Commands

Installed `scripts/task.sh` supports:
- `claim`
- `done`
- `status`
- `next`
- `plan`
- `finished`
- `upcoming`
- `needs-planning`
- `blocked`
- `summary`
- `learn`

Filters:
- `--today`
- `--last-24h`
- `--last-week`
- `--last-month`
- `--days`
- `--mine`
- `--agent`
- `--limit`