tasks

Manage tasks and bugs as Markdown files with YAML frontmatter in .sandpiper/tasks directory using ripgrep for search.

Updated Mar 20, 2026

Search Tags:#cli #task-management #project-management #yaml-frontmatter #task-tracker #markdown-tasks

Ready to run

npx skills add https://github.com/dljsjr/sandpiper-ai --skill tasks-dljsjr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tasks
Source: https://github.com/dljsjr/sandpiper-ai/tree/main/skills/sandpiper/tasks
Command: npx skills add https://github.com/dljsjr/sandpiper-ai --skill tasks-dljsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Task management within a project can be scattered and manual. This skill centralizes creation, updates, and querying of tasks, bugs, and subtasks as markdown files with YAML frontmatter, stored in the local project's .sandpiper/tasks directory to enable consistent status tracking and auditing.

Core Features & Use Cases

Create, update, and query tasks, bugs, and subtasks via a CLI or direct markdown files.
Maintain a local, project-scoped task index with automated status tracking, assignees, priorities, and activity history.
Use for planning sprints, tracking progress, and auditing work items across projects.

Quick Start

Create your first task with the sandpiper-tasks CLI and start organizing work in the local .sandpiper/tasks directory.

Frequently Asked Questions about tasks

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

FAQPage Schema

How do I manage project tasks using markdown files with YAML frontmatter?▼

You can manage project tasks by creating, updating, and querying markdown files with YAML frontmatter stored in a local .sandpiper/tasks directory. This approach enables consistent status tracking, assignee management, and activity auditing across projects.

Can I track bugs and subtasks in a local project workspace?▼

Yes, you can track bugs and subtasks in a local project workspace by storing them as markdown files with YAML frontmatter. The system maintains a project-scoped task index with automated status tracking, priorities, and activity history.

What's the best way to organize sprint planning and backlogs across projects?▼

Organizing sprint planning and backlogs across projects is best handled by centralizing work items as markdown files with YAML frontmatter in the .sandpiper/tasks directory. This enables consistent querying, status tracking, and work item auditing.

Do I need ripgrep to query markdown tasks and bugs?▼

Yes, ripgrep is required to search and query markdown tasks and bugs effectively. The local project workspace uses ripgrep to parse and retrieve task information from the YAML frontmatter and markdown bodies stored in the .sandpiper/tasks directory.

How does a CLI task tracker work with YAML frontmatter?▼

A CLI task tracker works with YAML frontmatter by writing task metadata, such as status, assignees, and priorities, into the header of local markdown files. This allows you to create, update, and query project work items directly from the command line.

Are there limitations to using markdown files for project task management?▼

Using markdown files for project task management requires a local project workspace with the ability to read and write YAML frontmatter. It is limited to local, project-scoped directories and does not inherently provide centralized cloud synchronization.