Tasknotes

Community

ArtemXTech

tasknotes

Manage tasks in Obsidian via TaskNotes plugin API. Use when user wants to create tasks, list tasks, query by status or project, update task status, delete tasks, or check what they need to do.

Overview

Publisher	ArtemXTech
Repository	`personal-os-skills`
Skill name	`tasknotes`
Stars	542
Forks	90
Bundled files	1
License	MIT
Links	Skill source Repository Homepage

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
1 bundled files
Scripts, templates, and references the model can read while it works. Files are read-only and never executed.
Open source
Published by ArtemXTech on GitHub. Read the source before you install it.

Installation

Install the Tasknotes AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/ArtemXTech/personal-os-skills/tree/main/skills/tasknotes
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/ArtemXTech/personal-os-skills.git /tmp/personal-os-skills
mkdir -p .claude/skills
cp -r /tmp/personal-os-skills/skills/tasknotes .claude/skills/tasknotes

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Tasknotes in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Tasknotes on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Tasknotes is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

TaskNotes Skill

Manage Obsidian tasks via the TaskNotes plugin HTTP API.

Requirements

TaskNotes plugin installed in Obsidian
Enable HTTP API in TaskNotes settings:
- Open Obsidian Settings → TaskNotes
- Enable "HTTP API" toggle
- Set API port (default: 8080)
- API token: leave empty for no auth, or set a token for security

Environment variables in .env file at vault root (if using auth):


TASKNOTES_API_PORT=8080
TASKNOTES_API_KEY=your_token_here

If TaskNotes has no auth token set, you don't need a .env file.

CLI Commands

bash
# List all tasks
uv run scripts/tasks.py list

# List by status (use your configured status values)
uv run scripts/tasks.py list --status "in-progress"

# List by project
uv run scripts/tasks.py list --project "My Project"

# Create task
uv run scripts/tasks.py create "Task title" --project "My Project" --priority high

# Create task with scheduled time
uv run scripts/tasks.py create "Meeting prep" --scheduled "2025-01-15T14:00:00"

# Update task status
uv run scripts/tasks.py update "Tasks/task-file.md" --status done

# Add/update task description
uv run scripts/tasks.py update "Tasks/task-file.md" --details "Additional context here."

# Delete task
uv run scripts/tasks.py delete "Tasks/task-file.md"

# Get available options (statuses, priorities, projects)
uv run scripts/tasks.py options --table

# Human-readable output (add --table)
uv run scripts/tasks.py list --table

Task Properties

Status and Priority values: Configured in your TaskNotes plugin settings. Run options command to see available values:

bash
uv run scripts/tasks.py options --table

Other fields:

projects - Array of project links, e.g. ["[[Project Name]]"]
contexts - Array like ["office", "energy-high"]
due - Due date (YYYY-MM-DD)
scheduled - Scheduled date/time (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)
timeEstimate - Minutes (number)
tags - Array of tags
details - Task description (writes to markdown body, not frontmatter)

API Reference

Base URL: http://localhost:8080/api

Method	Endpoint	Description
GET	/tasks	List tasks (supports filters)
POST	/tasks	Create task
GET	/tasks/{id}	Get single task
PUT	/tasks/{id}	Update task
DELETE	/tasks/{id}	Delete task
GET	/filter-options	Available statuses, priorities, projects

Query Parameters for GET /tasks

status - Filter by status
project - Filter by project name
priority - Filter by priority
tag - Filter by tag
overdue - true/false
sort - Sort field
limit - Max results
offset - Pagination offset

When to Use

"create a task for X" → create task
"show my tasks" → list all tasks
"show in-progress tasks" → list --status in-progress
"mark X as done" → update task status to done
"what should I work on" → list tasks by status

Example Workflow

bash
# Morning: Check what to work on
uv run scripts/tasks.py list --status in-progress --table
uv run scripts/tasks.py list --limit 5 --table

# Create task linked to project
uv run scripts/tasks.py create "Finish landing page" \
  --project "Website Redesign" \
  --priority high

# Complete a task
uv run scripts/tasks.py update "Tasks/finish-landing-page.md" --status done

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

scripts/tasks.py11 KB

Frequently asked questions

What does the Tasknotes AI skill do?

Manage tasks in Obsidian via TaskNotes plugin API. Use when user wants to create tasks, list tasks, query by status or project, update task status, delete tasks, or check what they need to do.

Why use Tasknotes on TypingMind?

Because you install it once and use it with any model. Tasknotes is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Tasknotes in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/ArtemXTech/personal-os-skills/tree/main/skills/tasknotes. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Tasknotes?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Tasknotes?

As many as you like. As long as a model supports skills, you can use Tasknotes with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Tasknotes AI skill free?

Yes. It is published on GitHub by ArtemXTech under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Bun Runtime

affaan-m

CommunityPopular

Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel support.

Competitive Report Structure

affaan-m

CommunityPopular

Use after benchmark-methodology has produced scored competitor profile cards. Assembles findings into a decision-grade report: landscape map, competitor profiles, benchmarking matrix, white-space…

Content Engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content…

Crosspost

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user…

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

TaskNotes Skill

Requirements

CLI Commands

Task Properties

API Reference

Query Parameters for GET /tasks

When to Use

Example Workflow

Bundled files

Frequently asked questions

Related AI Skills

Set up your own AI workspace now