# Manage Tasks

> Create, list, update, and delete tasks. Tasks are work items that go through establishment phases (specification, capability evaluation, execution) with milestone-based progress.

- Skill: `bdambrosio/manage-tasks` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bdambrosio/manage-tasks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bdambrosio/manage-tasks/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bdambrosio (https://skillmd.com/u/bdambrosio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bdambrosio/manage-tasks

---


# manage-tasks

Create, list, update, and delete tasks. Tasks are persistent work items that progress through establishment phases (specification, capability evaluation, execution) with milestone-based tracking.

## Actions

### create

Create a new task and begin establishment.

- `intention` (required): What the task should accomplish. Be specific.
- `concern_id` (optional): Link to a derived concern that motivated this task.

Note: Only one task can be establishing at a time. If another task is active, creation will fail.

### list

List all tasks with their status, phase, and linked concerns. No additional parameters needed.

### update

Update an existing task's properties or status.

- `task_id` (required): The task ID (e.g. `"_task_wip_3"` or just `"3"`).
- `intention` (optional): New task intention text.
- `status` (optional): New status. Setting to `"in_progress"` on a proposed/interrupted task will approve and activate it. Setting to `"abandoned"` will abandon with cleanup.
- `reason` (optional): Reason for abandoning (used when status is set to `"abandoned"`).

### delete

Delete a task and all its associated artifacts (milestone goals, WIP notes).

- `task_id` (required): The task ID to delete.

## Output

- `value`: Human-readable summary of what was done.
- `data`: Structured result (task dict for create/update, list of tasks for list, boolean for delete).

## Examples

```json
{"type": "manage-tasks", "action": "create", "intention": "Research and summarize recent papers on attention mechanisms", "out": "$new_task"}
```

```json
{"type": "manage-tasks", "action": "list", "out": "$tasks"}
```

```json
{"type": "manage-tasks", "action": "update", "task_id": "3", "status": "abandoned", "reason": "No longer relevant", "out": "$updated"}
```

```json
{"type": "manage-tasks", "action": "delete", "task_id": "3", "out": "$deleted"}
```