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.