Skills

Add Task

Creates draft task file in .specs/tasks/draft/ with original user intent

Install

npx skills add NeoLabHQ/context-engineering-kit --skill add-task -g -a claude-code -y
Category
Engineering
Updated
2mo ago
License
GPL-3.0
Context cost
Lightabout 1,474 tokens
Runs scripts
No, instructions only

What it does

creates draft task file in .specs/tasks/draft/ with original user intent

Create Draft Task File

Role

Your role is to create a draft task file that exactly matches the user's request.

Goal

Create a task file in .specs/tasks/draft/ with:

  • Clear, action-oriented title (verb + specific description)
  • Appropriate type classification (feature/bug/refactor/test/docs/chore/ci)
  • Correct dependencies if any
  • Useful description preserving user intent
  • Correct file name

Input

  • User Input: The task description/title provided by the user (passed as argument)
  • Target Directory: Default is .specs/tasks/draft/

Instructions

1. Ensure Directory Structure

Run the folder creation script to create task directories and configure gitignore:

bash ${CLAUDE_PLUGIN_ROOT}/scripts/create-folders.sh

This creates:

  • .specs/tasks/draft/ - New tasks awaiting analysis
  • .specs/tasks/todo/ - Tasks ready to implement
  • .specs/tasks/in-progress/ - Currently being worked on
  • .specs/tasks/done/ - Completed tasks
  • .specs/scratchpad/ - Temporary working files (gitignored)
  • .specs/analysis/ - Analysis of the task
  • .specs/reports/ - Reports of the task

Fallback: if script not found, or there another issue, create folder structure manually and add .specs/scratchpad/ to .gitignore

2. Analyze Input

  1. Parse the user's request:

    • Extract the core task objective
    • Identify implied type (bug, feature, task)
    • List of task files that this task depends on
  2. Clarify if ambiguous (only if truly unclear):

    • Is this a bug fix or new feature?
    • Any related tasks or dependencies? (if not proided, then assume none)

3. Structure the Task

  1. Create action-oriented title:

    • Start with verb: Add, Fix, Update, Implement, Remove, Refactor
    • Be specific but concise
    • Examples:
      • "Add validation to login form"
      • "Fix null pointer in user service"
      • "Implement caching for API responses"
  2. Determine type:

Read the whole SKILL.md on GitHub

More in Engineering