obsidian-tasks

Automate GTD task capture and formatting in Obsidian notes.

Updated Dec 26, 2023
One-click install
npx skills add https://github.com/Selogaz/Obsidian-vault-cpp --skill obsidian-tasks-selogaz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-tasks
Source: https://github.com/Selogaz/Obsidian-vault-cpp/tree/main/skills/obsidian-tasks
Command: npx skills add https://github.com/Selogaz/Obsidian-vault-cpp --skill obsidian-tasks-selogaz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users capture and format GTD tasks directly in Obsidian notes, ensuring consistent tagging and structured task data to streamline personal and team productivity.

Core Features & Use Cases

  • Task Format: Use the standard line - [ ] #task/TYPE #category/CATEGORY Description to create tasks.
  • Task Types: Includes inbox, next_action, one-off, multistep, waiting_for, regular, idea, reference, someday to cover both quick captures and complex workflows.
  • Dynamic Categories: Categories are discovered at runtime from base/categories/*.md; never hardcode categories to keep tagging flexible.
  • Workflow: Discover existing categories, map to #category/ tags, apply the most relevant category, and gracefully skip category when none exists.

Quick Start

Create a new task by writing a line in your Obsidian note using the format - [ ] #task/TYPE #category/CATEGORY Description.

Frequently Asked Questions about obsidian-tasks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I format GTD tasks in Obsidian notes?

To format GTD tasks in Obsidian notes, use the standard line format: - [ ] #task/TYPE #category/CATEGORY Description. This structure ensures consistent tagging and streamlines task data for productivity workflows.

What GTD task types can I use for capturing work in Obsidian?

Obsidian GTD task capture supports inbox, next_action, one-off, multistep, waiting_for, regular, idea, reference, and someday types to handle both quick captures and complex workflows.

How do I create custom categories for Obsidian task tagging?

Custom categories for Obsidian task tagging are discovered dynamically at runtime from markdown files located in base/categories/*.md. You should never hardcode categories to keep tagging flexible.

Can I use this for team task management within Obsidian notes?

Yes, this applies to both personal productivity workflows and team task management within Obsidian notes. It reads frontmatter-defined names and descriptions to guide consistent task creation and categorization.

What happens when no existing category matches my Obsidian task?

When no existing category matches your Obsidian task, the workflow gracefully skips the category tagging step. It first discovers existing categories and maps them to #category/ tags before applying the most relevant one.

What is the best way to structure an Obsidian inbox for GTD?

The best way to structure an Obsidian inbox for GTD is to use the #task/inbox type with the standard line format. This allows quick capture while maintaining structured task data for later categorization.