Skip to content
Skills Library
Personal productivity · Automation

task-init

/task-init

This skill should be used when the user asks to "initialize taskwarrior", "set up taskwarrior", "configure taskwarrior for this project", "run /init for taskwarrior", "set up task management", "bootstrap the task plugin", "configure task contexts", or "first-time taskwarrior setup". Guides the complete initial configuration of Taskwarrior so that the task-workflow skill operates correctly.

Licence
MIT
Last repository change
18.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 18.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

This skill should be used when the user asks to "initialize taskwarrior", "set up taskwarrior", "configure taskwarrior for this project", "run /init for taskwarrior", "set up task management", "bootstrap the task plugin", "configure task contexts", or "first-time taskwarrior setup". Guides the complete initial configuration of Taskwarrior so that the task-workflow skill operates correctly.

Triggers from the description

initialize taskwarriorset up taskwarriorconfigure taskwarrior for this projectrun /init for taskwarriorset up task managementbootstrap the task pluginconfigure task contextsfirst-time taskwarrior setup

Arguments

/task-init [project-name]
Original author description

This skill should be used when the user asks to "initialize taskwarrior", "set up taskwarrior", "configure taskwarrior for this project", "run /init for taskwarrior", "set up task management", "bootstrap the task plugin", "configure task contexts", or "first-time taskwarrior setup". Guides the complete initial configuration of Taskwarrior so that the task-workflow skill operates correctly.

How it works

  1. Step 1: Verify Installation
  2. Step 2: Verify Data Directory
  3. Step 3: Configure Core Defaults
  4. Step 4: Configure Project Contexts (Optional)
  5. Step 5: Configure an Initial Project
  6. Step 6: Configure Obsidian Vault (Optional)
  7. Step 7: Verify Setup
  8. Step 8: Show Quick Reference
  9. Common Post-Setup Tasks
  10. Troubleshooting
Original SKILL.md headings · 144 lines, 565 words
SKILL.md preview
---
name: task-init
description: >
  This skill should be used when the user asks to "initialize taskwarrior", "set up taskwarrior",
  "configure taskwarrior for this project", "run /init for taskwarrior", "set up task management",
  "bootstrap the task plugin", "configure task contexts", or "first-time taskwarrior setup".
  Guides the complete initial configuration of Taskwarrior so that the task-workflow skill
  operates correctly.
argument-hint: "[project-name]"
allowed-tools:
  - Bash
  - Read
  - Write
---

# Taskwarrior Initialization

Set up Taskwarrior for use with this plugin. Run these steps in order. Taskwarrior must
be installed and accessible as the `task` command before proceeding.

## Step 1: Verify Installation

```bash
task --version
```

If missing, install:
- macOS: `brew install task`
- Ubuntu/Debian: `sudo apt install taskwarrior`
- Arch: `sudo pacman -S task`
- Windows: `winget install GnuPG.GnuPG && scoop install task`

## Step 2: Verify Data Directory

```bash
task config data.location
# Default: ~/.task — acceptable for most setups
```

## Step 3: Configure Core Defaults

Apply these settings to reduce friction during daily use:

```bash
# Disable interactive confirmation prompts for scripting
task config confirmation off

# Show task IDs and affected counts in output
task config verbose label,new-id,affected,edit,special,project,sync,filter,footnote,recur,unwait

# Default priority when none specified
task config default.priority M

# Enable urgency inheritance — blocked tasks adopt blocker urgency
task config urgency.inherit 1

# Boost urgency for the +next tag
task config urgency.user.tag.next.coefficient 15.0

# Boost urgency for +urgent tag
task config urgency.user.tag.urgent.coefficient 10.0
```

## Step 4: Configure Project Contexts (Optional)

Define contexts to focus the task view by project area:

```bash
# Work context — shows only work tasks
task context define work "project:Work or +work"

# Home context — shows only personal tasks
task context define home "project:Home or +home"

# List defined contexts
task context list

# Switch context (or disable)
task context work
task context none
```

Adapt context names and filters to the user's project structure.

## Step 5: Configure an Initial Project

If the user provided a project name via argument, create a starter task:

```bash
# Create a kickoff task for the project
task add "Project setup complete" project:<ProjectName> priority:L
task <new-id> done
```

This seeds the project in Taskwarrior's project list.

## Step 6: Configure Obsidian Vault (Optional)

If the user uses Obsidian for notes, configure the vault reference file so that
annotation URIs work correctly:

1. Find the vault name: check `~/.config/obsidian/` or the `OPENCLAW_NOTES_DIR` env var
2. Edit `skills/task-workflow/references/obsidian-vault.md` with:
   - Vault name
   - Base path on disk
   - Any PARA structure patterns for this project

## Step 7: Verify Setup

Run the summary script to confirm everything is working:

```bash
bash $CLAUDE_PLUGIN_ROOT/skills/task-workflow/scripts/tw-summary.sh
```

Expected output: summary header with sections for overdue, today, active, and next.
If `task` errors, check `task config data.location` and re-run Step 2.

## Step 8: Show Quick Reference

After initialization completes, display this reference to the user:

```
Taskwarrior initialized. Core workflow:

  Add:     task add "description" project:Name
  Start:   task <id> start
  Note:    task <id> annotate "note or URL"
  Done:    task <id> done
  View:    task next

Contexts: task context work / task context none
Summary:  task next | task +OVERDUE list | task +TODAY list
```

## Common Post-Setup Tasks

```bash
# Check what's pending
task next

# Add first real task
task add "First task" project:MyProject priority:M

# Verify urgency ordering makes sense
task list
```

## Troubleshooting

| Problem | Fix |
|---------|-----|
| `task: command not found` | Install via package manager (Step 1) |
| `No matches` on any filter | No tasks exist yet — add one (Step 5) |
| Permission error on `~/.task` | `mkdir -p ~/.task && chmod 700 ~/.task` |
| Confirmations blocking scripts | `task config confirmation off` (Step 3) |
| Context filters too narrow | `task context none` to disable temporarily |

Versions

RepositoryScoreLicence
This page · kjgarza/marketplace-claude100MIT
Mozurok/fhorja.dev100MIT

Database snapshot: 13.11.2026 · package version dc2686d6cd1c (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100taskwarrior
    Use when querying or modifying tasks via the taskwarrior CLI - dense recipes for listing, single-field lookups, multi-task batched lookups, full-text search, and the soft description-length convention. Activates on `task list`, `task add`, `task info`, `task done`, "what's on…
  • 100session-wrap
    End-of-session capture to taskwarrior, optional journal, GitHub issues. Use when user says wrap up, session wrap, or done for now.
  • 100task-workflow
    This skill should be used when an AI agent needs to "add a task", "create a task", "update a task", "modify a task", "complete a task", "mark task done", "close a task", "start working on a task", "annotate a task with notes", "add context to a task", "log progress on a task",…
  • 100task-calendar
    Use when the user wants to "schedule a task", "block time for a task", "add task to calendar", "check if I'm free", "find a slot for this", "when can I work on", "create a calendar event for a task", "reschedule this task", or any request that bridges a Taskwarrior task with…
  • 100task-done
    Close a taskwarrior task with landing commit annotation and optional GitHub issue/PR close. Use when finishing a coordination task or marking a work order complete.
  • 100init-tasks
    Set up the task tracking system with tasks/todo.md, tasks/lessons.md, retro.md, and changelogs/ directory. This is the standard project management system used across all serious projects. Use when the user says "init tasks", "set up task tracking", "add task system", "create…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.