Task List

Run a conversational task list with Inbox, Today, Upcoming, recurring tasks, waiting items, projects, and review loops that stay trustworthy.

Security Scan

The skill is internally consistent: it is an instruction-only local task-list that reads and writes files under ~/task-list/ and does not request external credentials or network installs.

Purpose & Capability

Name and description match the behavior described in SKILL.md and supporting docs: a conversational task manager that stores a local workspace under ~/task-list/. No unrelated binaries, services, or credentials are requested.

Instruction Scope

Runtime instructions confine data to local Markdown files under ~/task-list/ and explicitly state no data leaves the machine by default. One wording concern: setup.md instructs the agent to “read this silently” and “do not mention file names, folders, setup, or configuration,” which could be misread as encouraging stealthy behavior. However, elsewhere the docs state the agent must ask before creating local continuity and only save data with user consent. This is a minor UX/clarity issue rather than a technical mismatch, but you should be aware of the ambiguous phrasing.

Install Mechanism

No install spec, no code files, and no downloads — instruction-only. This is low risk and appropriate for a skill whose data is stored locally.

Credentials

The skill requests no environment variables, no credentials, and no config paths outside its declared ~/task-list/ workspace. The requested access is proportional to a local task-list feature.

Persistence & Privilege

always is false and the skill does not request system-wide modifications or access to other skills' configs. It will create and manage files only within its own workspace, and the docs explicitly require asking before creating persistent continuity.

Assessment

This skill appears to do what it says: local conversational task management stored in ~/task-list/. Before enabling continuity, confirm you are comfortable with files being created under your home directory and that the agent will ask for consent before creating them. If you want stricter transparency, ask the agent to explicitly tell you when it will create or modify files (don’t rely on implicit or “silent” setup behavior). Because the skill contains no network calls or credentials by default, the primary risk is accidental local data storage — review the created Markdown files and their permissions, and back them up if they will hold sensitive information.

Setup

On first use, read setup.md for activation boundaries, continuity rules, and how to introduce the system without turning it into a form.

When to Use

User wants to manage a task list by talking naturally instead of filling a UI. The agent should capture tasks, clarify them into clean next actions, and maintain stable views like Inbox, Today, Upcoming, Anytime, Someday, and Waiting.

Use this when the user wants Things or Todoist behavior from conversation: quick capture, predictable sorting, recurring work, project structure, and weekly review without silent changes.

Architecture

Memory lives in ~/task-list/. If the user wants continuity and ~/task-list/ does not exist, run setup.md. See memory-template.md for the durable context file and workspace-format.md for the local file layout.

~/task-list/
├── memory.md       # Durable preferences and activation boundaries
├── inbox.md        # Raw captures that still need clarification
├── tasks.md        # Active tasks across Today, Upcoming, Anytime, Someday
├── projects.md     # Finite outcomes with next actions and deadlines
├── areas.md        # Ongoing responsibilities without end dates
├── recurring.md    # Recurrence rules and regeneration behavior
├── waiting.md      # Delegated or blocked work with chase dates
└── log.md          # Recently completed, dropped, or major field changes

Quick Reference

Topic	File
First-use behavior	setup.md
Durable memory	memory-template.md
Local workspace files	workspace-format.md
Capture and clarification	capture-and-clarify.md
Views and sorting rules	views-and-sorting.md
Dates, recurrence, and waiting	recurrence-and-waiting.md
Daily and weekly review loops	review-rhythm.md

Core Rules

1. Capture first, clarify second

• Never block raw capture on missing metadata.
• If the user brain-dumps multiple items, capture them all first, then clarify only the fields that materially change execution.
• Default ambiguous items to Inbox instead of pretending certainty.
• Use capture-and-clarify.md to decide what to infer versus what to ask.

2. Preserve task semantics exactly

• Keep due date, start or defer date, recurrence rule, completion time, and waiting state as separate concepts.
• "Due Friday" is different from "show me this Friday" and different again from "snooze until Friday."
• If a date phrase could change the outcome, ask once and record the clarified meaning.
• Use recurrence-and-waiting.md for exact date and repeat behavior.

3. One task equals one visible next action

• Rewrite vague items into a task title that starts with a verb and can be advanced in one focused work block.
• If the user names an outcome with multiple steps, create a project plus the next visible action instead of one bloated task.
• Preserve important original wording in notes or context when rewriting could hide nuance.
• Use workspace-format.md for the project and task record shape.

4. Keep views stable and predictable

• The same task should land in the same view every time given the same fields.
• Sort by bucket first, then date, then urgency, then intentional manual order.
• Today is for work that should be seen now, not for every overdue item in the system.
• Use views-and-sorting.md whenever listing or re-listing tasks.

5. Separate projects, areas, and waiting work

• Projects are finite outcomes with a defined done condition.
• Areas are ongoing responsibilities such as finance, health, hiring, or household operations.
• Waiting work must keep owner, blocker, last follow-up, and next chase date visible so delegated tasks do not disappear.
• Never collapse all of this into one flat list.

6. Make every structural change explicit

• Confirm destructive or high-trust changes: delete, archive, mark done, recur, reschedule, or bulk move.
• When you change a task, say what changed in plain language.
• Never silently merge duplicates, invent deadlines, or mark something completed without the user's intent.
• Use the logging patterns from workspace-format.md for meaningful changes only, not noisy chatter.

7. Review ruthlessly to keep trust

• Run lightweight daily triage to empty Inbox, refresh Today, and surface real blockers.
• Run a weekly reset to prune stale tasks, expose overcommitment, and ensure every active project has a next action.
• Suggest defer, drop, delegate, or Someday when the list exceeds realistic capacity.
• Use review-rhythm.md for the minimum review loop.

Common Traps

• Turning every conversation into a questionnaire -> capture becomes slower than opening a task app.
• Mixing due dates and start dates -> tasks appear too early, too late, or in the wrong view.
• Treating projects and areas as the same thing -> review quality collapses as the list grows.
• Hiding delegated work inside generic blocked tasks -> follow-up risk becomes invisible.
• Keeping everything in Today -> the user stops trusting the list and avoids it.
• Rewriting task meaning too aggressively -> clean titles look nice but destroy intent.
• Auto-completing or auto-rescheduling without saying so -> trust is lost immediately.

Security & Privacy

Data that leaves your machine:

• None by default.

Data that stays local:

• Task records and preferences under ~/task-list/ if the user wants continuity.

This skill does NOT:

• Access files outside ~/task-list/ for storage.
• Make undeclared network requests.
• Send reminders or run automations without explicit user approval.
• Modify its own skill instructions.

Related Skills

Install with clawhub install <slug> if user confirms:

• assistant - Chief-of-staff style execution across tasks, messages, and follow-through.
• daily-planner - Turn tasks into a realistic day plan with protected focus blocks.
• memory - Keep durable context when the user wants broader long-term recall.
• plan - Build structured plans when a task grows into a multi-step initiative.
• projects - Manage deeper project tracking beyond a simple task list.

Feedback

• If useful: clawhub star task-list
• Stay updated: clawhub sync