Skip to content
Skills Library
Personal productivity · Automation

add-task

/add-task

Use when you want to quickly capture a new task in the vault from a title, with optional priority and due date.

Licence
MIT
Last repository change
16.07.2026

Assessment and security

98/ 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.
Hygiene13 / 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 16.07.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

Use when you want to quickly capture a new task in the vault from a title, with optional priority and due date.

Original author description

Use when you want to quickly capture a new task in the vault from a title, with optional priority and due date.

How it works

  1. Step 1: Resolve Task Details
  2. Step 2: Detect Project
  3. Step 3: Duplicate Check
  4. Step 4: Create Task Note
  5. Step 5: Fill Description (if provided)
  6. Step 6: Confirm
Original SKILL.md headings · 83 lines, 366 words
SKILL.md preview
---
name: add-task
description: Use when you want to quickly capture a new task in the vault from a title, with optional priority and due date.
---

# Add Task — Fast Vault Task Capture

Create a task note with minimal friction. Duplicate check → create → confirm. Done in one pass.

## Step 1: Resolve Task Details

Extract from skill arguments or the user's message:

| Field | Source | Default |
|---|---|---|
| **title** | args / message | required — ask if missing |
| **priority** | args | `normal` |
| **due** | args (any recognisable date) | none |
| **description** | remaining text after title/priority/due | none |

Priority shorthands: `h` / `hi` / `high` → `high`; `u` / `urg` / `urgent` → `urgent`; `l` / `lo` / `low` → `low`; anything else → `normal`.

## Step 2: Detect Project

Read CLAUDE.md for the `# PKM: <path>` line (regex: `/^#\s+PKM:\s*(.+)$/m`):
- **Matched**: use the vault project path (e.g., `01-Projects/Obsidian-MCP`)
- **No match**: ask which project, or offer `00-Inbox` for unassigned tasks

Task path: `<project>/tasks/<kebab-title>.md`
- `<kebab-title>` = title lowercased, spaces → `-`, strip characters other than `a-z0-9-`
- `<project-folder-name>` for the `project:` frontmatter field is the **basename** of the vault path (e.g., `Obsidian-MCP` from `01-Projects/Obsidian-MCP`)

## Step 3: Duplicate Check

```
vault_semantic_search({ query: "<title>", folder: "<project>", limit: 3, threshold: 0.7 })
```

If unavailable (no `VAULT_PKM_OPENAI_KEY`):
```
vault_search({ query: "<title>", folder: "<project>" })
vault_query({ type: "task", folder: "<project>" })
```

If a similar task exists (similarity > 0.8 or exact/near-exact title in search results):
> "Similar task found: `<path>` — `<title>`. Create a new one anyway, or skip?"

If skipping, exit cleanly. If creating anyway, proceed.

## Step 4: Create Task Note

```
vault_write({
  template: "task",
  path: "<task-path>",
  frontmatter: {
    tags: ["task"],
    status: "pending",
    priority: "<priority>",
    project: "<project-folder-name>",
    ...(due ? { due: "<YYYY-MM-DD>" } : {})   // omit due entirely if not provided
  }
})
```

## Step 5: Fill Description (if provided)

If a description was given in Step 1, append it into the Description section:

```
vault_append({
  path: "<task-path>",
  heading: "## Description",
  position: "after_heading",
  content: "<description>"
})
```

Skip if no description was provided — leave the section blank for later.

## Step 6: Confirm

Report the created task concisely:

> **Task created**: `<project>/tasks/<kebab-title>.md`
> Priority: `<priority>` · Due: `<due or none>` · Status: `pending`

Versions

RepositoryScoreLicence
This page · AdrianV101/obsidian-pkm-plugin98MIT
microbus-io/fabric100Apache-2.0
driangle/taskmd100MIT
driangle/taskmd100MIT
tbeack/fsad_playbook84MIT

Database snapshot: 13.11.2026 · package version b818e103cf29 (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

  • 90pb-todo
    Turn one sentence into a task line in the right to-do list, with project, priority and optional due date. Use for "add a to-do", "remember to ...", "put this on my list", "quick task". Nothing leaves your computer.
  • 100secondbrain-task
    This skill should be used when the user asks to "create task", "add todo", "track action item", "create ticket", "new task", "remind me to", "need to do", "add to backlog", or mentions needing to track work items with priority and status in their secondbrain.
  • 90org-capture
    Create new org-mode headings and notes via the org MCP server. Use when the user wants to add a new task, note, journal entry, or any new heading to their org files. Triggers: "add a task", "create a note", "capture this", "log an entry", "add to my notes", "create a TODO", "add…
  • 100vault-knowledge
    This skill should be used when working on any project to understand how to effectively interact with the Obsidian knowledge vault. It teaches when to capture knowledge, what to capture, how to format vault notes, and how to search effectively. Use when you need to "save to…
  • 100todo
    This skill should be used when the user asks to "add a todo", "add a task", "remind me to", "add to things", "create a todo", "save a task", "todo", or wants to add items to their Things 3 task manager.
  • 100obsidian-capture
    Save a note, decision, or thought to the Obsidian vault right now. Use when someone says "capture this", "save this to Obsidian", "note this down", "log this decision", "obsidian note", "save this for later", "capture that idea". Requires OBSIDIAN_VAULT_PATH to be set.

Feedback and reports

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