add-task

Add tasks to beads repositories with project inference and custom fields.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/builtby-win/skills --skill add-task-builtby-win
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-task
Source: https://github.com/builtby-win/skills/tree/main/plugins/todo/skills/add-task
Command: npx skills add https://github.com/builtby-win/skills --skill add-task-builtby-win

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines task management by allowing users to add tasks to their 'beads' repositories with intelligent project inference, eliminating manual project selection for common workflows.

Core Features & Use Cases

  • Task Creation: Add new tasks with titles, priorities, projects, and tags.
  • Smart Project Inference: Automatically determines the correct 'beads' repository based on the current directory, Git root, or a list of all found repositories.
  • Use Case: Quickly add a task like "Prepare Q3 report" to your 'personal-projects' beads repository without needing to specify the project path every time.

Quick Start

Add a high-priority security task to your 'webapp' project by typing /todo -p 1 --project webapp Fix login vulnerability.

Frequently Asked Questions about add-task

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

FAQPage Schema
How do I add tasks to a beads repository from the command line?

To add tasks to a beads repository, use the command line interface to specify a title, priority, project, and tags. The skill appends the new task with a unique ID to the issues.jsonl file.

How does project inference work when adding a todo?

Project inference automatically determines the correct beads repository by checking the current directory, locating the Git root, or scanning a list of all found .beads directories to eliminate manual project selection.

Can I assign priority and tags when creating a new task?

Yes, you can assign priority, project, and tags when creating a new task. Use command flags like -p for priority and --project to specify the target repository for the task.

Do I need a specific directory structure to manage tasks in beads?

You need a .beads directory structure within your project. The Python scripts locate this directory to generate unique task IDs and append the tasks to the issues.jsonl file.

What is the best way to quickly add a high priority task to a specific project?

The best way to quickly add a high priority task is to use the todo command with priority and project flags, such as typing /todo -p 1 --project webapp followed by your task title.

Why does my task management command not find the correct beads repository?

If task inference fails to find the correct beads repository, ensure your current working directory is inside the intended Git repository or that the .beads directory is properly initialized.