project_tasks

Create and manage persistent user-visible project tasks with dependencies and approval workflows.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/AmirEmad11/instabot --skill project-tasks-amiremad11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project_tasks
Source: https://github.com/AmirEmad11/instabot/tree/main/.local/skills/project_tasks
Command: npx skills add https://github.com/AmirEmad11/instabot --skill project-tasks-amiremad11

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multi-step project work with a user requires tracking deliverables that persist across sessions, but an agent's internal task list is invisible and temporary. This Skill provides persistent, user-visible project tasks with states, dependencies, and an approval flow so users can see and control high-level milestones. ## Core Features & Use Cases - Task lifecycle management: Create tasks in bulk from markdown plan files, propose them for user approval, and track states from PROPOSED through MERGED or CANCELLED. - Search and listing: Query tasks with boolean search syntax, filter by state or task refs, and retrieve full task details including dependencies. - Dependency and artifact tracking: Declare dependencies between tasks via dependsOn and tag artifact-producing tasks with kinds like web, mobile, or slides. - Use Case: A user asks for a payment integration. You write a plan file to .local/tasks/payment-integration.md, create the task with bulkCreateProjectTasks, propose it for approval, and later check progress with listProjectTasks as a task agent implements it. ## Quick Start Create a project task for my requested feature by writing a plan file and proposing it for my approval.

Frequently Asked Questions about project_tasks

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

FAQPage Schema
How do I create a project task with a plan file?

Write a markdown plan file to .local/tasks/ with sections for What & Why, Done looks like, Out of scope, Steps, and Relevant files. Then call bulkCreateProjectTasks with the title and filePath, and the file content becomes the task description.

What is the difference between project tasks and an internal task list?

Project tasks are persistent across sessions, visible to the user, and track high-level deliverables. The internal task list is session-only, agent-private, and meant for detailed implementation steps the user does not need to see.

How do task dependencies work when creating multiple tasks?

Pass dependsOn with id aliases of other tasks in the same batch or task refs of existing tasks that are PENDING or later. Never depend on existing PROPOSED tasks, though tasks within the same batch may depend on each other freely.

Can I search project tasks with boolean queries?

Yes, searchProjectTasks supports quoted exact phrases, space-separated terms requiring both words, OR for alternatives, and a minus prefix to exclude terms. You can also pass a BCP 47 locale for better stemming in non-English queries.

When should I not use project tasks?

Do not use project tasks for internal agent work breakdown, temporary implementation steps, or sub-tasks that only matter to the agent. Those belong in the internal task list since they are not user-visible deliverables.

What do the project task states mean?

Tasks move from PROPOSED (awaiting user approval) to PENDING, IN_PROGRESS, IMPLEMENTED, MERGING, and MERGED. BLOCKED_BY_DRIFT means an upstream task diverged from its plan, and CANCELLED means abandoned.