apx-task

Manages per-project to-do tasks with subtasks, comments, and board columns via an event-sourced JSONL store.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-task-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-task
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-task
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-task-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping track of pending work across multiple projects is hard when notes live in chats, memory, or scattered files. This Skill gives each project a persistent, event-sourced to-do list where tasks can be created, listed, edited, reassigned, split into subtasks, commented on, and moved across board columns — all addressable by short id prefixes. ## Core Features & Use Cases - Full task lifecycle: Add, list, show, patch, complete, drop, and reopen tasks per project, with filters by status, tag, agent, due date, and update time. - Subtasks and comments: Split an epic into child tasks and hold threaded discussions; an @mention in a comment summons an agent to run a real turn against the task. - Board columns and agent handoff: Move open tasks across configurable columns (pending, running, in_review, blocked), with optional on_enter agent assignment for automated handovers. - Use Case: A user says "remind me to call the accountant before Friday" — the Skill creates a dated task in the right project; later "what's pending everywhere?" lists open tasks across all projects in one call. ## Quick Start Ask the agent to add a task to a specific project, for example: "Add a task to the acme project to review the auth bug, due Friday, tagged urgent."

Frequently Asked Questions about apx-task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a task to a specific project?▼

Use the create_task tool or run apx task add with the --project flag, for example: apx task add "Review the auth bug" --project acme. Always pass the project explicitly, since omitting it falls back to the first registered project.

How do I list all pending tasks across every project?▼

Call list_tasks without a project argument to get open tasks from every project in one call, or run apx task list --all from the CLI. You can filter by status, tag, agent, due date, or update time.

What is the difference between a task description and body?▼

The description tells the human owner what to do and is shown in the panel and task views. The body is the prompt an agent receives if it executes the task, so leave body empty for ordinary human to-dos.

Can I edit a task by modifying the JSONL log file directly?▼

No. The event log is append-only and editing it in place bypasses store normalizers, producing unrecoverable state. Use the update_task tool or apx task patch, which cover every editable field.

How do I move a task to a different board column?▼

Use complete_task with action "status" and the target column, which validates against the project's column catalog. The update_task patch cannot set status, and closing a task uses action "done" or "drop" instead.

When should I use drop instead of done on a task?▼

Use done when the work was actually completed and drop when the task is no longer relevant and should be archived without completion. Reporting and metrics distinguish the two outcomes.