dot-tasks

Create, start, and log repository tasks with spec.md and plan.md artifacts.

2|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Awni00/dot-tasks --skill dot-tasks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dot-tasks
Source: https://github.com/Awni00/dot-tasks/tree/main/agent-tools/skills/dot-tasks
Command: npx skills add https://github.com/Awni00/dot-tasks --skill dot-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

dot-tasks provides a structured workflow to manage and track repository tasks in a local .tasks/ directory, delivering auditable task state for humans and AI agents.

Core Features & Use Cases

  • End-to-end task lifecycle: create, start, log activity, and complete tasks with spec.md and plan.md artifacts.
  • AI-agent integration: guides agents through task planning, execution, and progress reporting with clear separation of spec, plan, and task state.
  • Auditability and reproducibility: keeps a transparent trail of decisions and progress in markdown artifacts.

Quick Start

Initialize a dot-tasks project in your repository and start tracking your first task.

Frequently Asked Questions about dot-tasks

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

FAQPage Schema
How do I manage AI agent task states in a local repository?▼

You can manage AI agent task states by applying dot-tasks to move items through todo, doing, and done states within a local .tasks directory. This workflow provides auditable task tracking using markdown artifacts.

What is the best way to log AI agent activity in software projects?▼

Logging AI agent activity is best handled by generating spec.md, plan.md, and task.md artifacts in a local .tasks directory. This approach creates an auditable trail of decisions and progress for both humans and agents.

How do I structure task planning and execution for AI assistants?▼

You can structure task planning and execution by separating specifications, plans, and task states into distinct markdown files. This guides AI agents through structured execution and clear progress reporting.

Do I need a specific CLI to coordinate repo tasks with dot-tasks?▼

Yes, you need a compatible dot-tasks CLI to create, start, and log tasks. The workflow relies on this CLI alongside a local .tasks directory containing your markdown artifacts.

Can I use markdown files to track reproducible task workflows in software projects?▼

Yes, you can use markdown files to track reproducible task workflows by storing spec.md and plan.md artifacts locally. This keeps a transparent trail of decisions and progress throughout the task lifecycle.

What are the limitations of tracking repository tasks in a local directory?▼

Tracking repository tasks in a local directory requires maintaining a .tasks folder and relies on a compatible CLI. The workflow is designed for local software projects and may not suit distributed team environments without additional sync setup.