add-task

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