# add-task

Turns your request into a task file under .specs/tasks/draft/, with a verb-first title, a type and your original wording. The first step of a spec-driven workflow.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 1787
- Author: NeoLabHQ
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NeoLabHQ/context-engineering-kit/tree/HEAD/skills/add-task/SKILL.md
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/skills/add-task

## What it does

Pass the skill a task description and it writes a draft. The title opens with a verb such as Add, Fix, Implement, Update, Remove or Refactor and says what exactly changes. The type lands in the file extension: `feature`, `bug`, `refactor`, `test`, `docs`, `chore` or `ci`. The name comes from the title in lowercase joined by hyphens, three to five words, shaped as `<short-name>.<issue-type>.md`.

Before writing, it runs `bash ${CLAUDE_PLUGIN_ROOT}/scripts/create-folders.sh`. That script sets up `draft`, `todo`, `in-progress`, `done`, `scratchpad`, `analysis` and `reports` inside `.specs` and adds `scratchpad` to `.gitignore`. No script? You build the folders yourself and edit `.gitignore` by hand. Then the skill checks every status folder for an existing file with the same name so nothing gets overwritten.

The task file holds the title, an optional `depends_on` list and your exact request under “Initial User Prompt”. The description stays a placeholder for a later stage; the skill does not fill it in and does not call the planner. Handy when your project keeps tasks as folders in the repo, because every record ends up looking the same.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill add-task -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/add-task/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/add-task/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill add-task -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/add-task/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill add-task -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/add-task/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NeoLabHQ/context-engineering-kit add-task
```

2. **Manually: put the files in place**
- File: `.github/skills/add-task/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill add-task -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NeoLabHQ/context-engineering-kit --path skills/add-task
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/add-task/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill add-task -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NeoLabHQ/context-engineering-kit/tree/HEAD/skills/add-task/SKILL.md

## When to use it
- turn a one-line chat request into a tracked task file
- tag each task with its type in the file name
- keep the original wording verbatim
- make sure a new file name is free across status folders
- set up `.specs` folders and keep `scratchpad` out of git

## Example prompts
- Add a task: fix the login timeout on slow connections
- Create a task to refactor the auth module
- Add a task for writing parser config tests

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [neolabhq/context-engineering-kit](https://affpapa.org/en/nevibecode/by/neolabhq/context-engineering-kit.md) — 64 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md