# Send Obsidian Tasknotes to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "obsidian-plugin-tasknotes",
    "name": "Obsidian Tasknotes",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/benoitjadinon/obsidian-plugin-tasknotes",
    "canonicalUrl": "https://clawhub.ai/benoitjadinon/obsidian-plugin-tasknotes",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/obsidian-plugin-tasknotes",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=obsidian-plugin-tasknotes",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/tasks.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "obsidian-plugin-tasknotes",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T08:17:06.022Z",
      "expiresAt": "2026-05-13T08:17:06.022Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=obsidian-plugin-tasknotes",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=obsidian-plugin-tasknotes",
        "contentDisposition": "attachment; filename=\"obsidian-plugin-tasknotes-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "obsidian-plugin-tasknotes"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/obsidian-plugin-tasknotes"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/obsidian-plugin-tasknotes",
    "downloadUrl": "https://openagent3.xyz/downloads/obsidian-plugin-tasknotes",
    "agentUrl": "https://openagent3.xyz/skills/obsidian-plugin-tasknotes/agent",
    "manifestUrl": "https://openagent3.xyz/skills/obsidian-plugin-tasknotes/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/obsidian-plugin-tasknotes/agent.md"
  }
}
```
## Documentation

### 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

# 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:

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

MethodEndpointDescriptionGET/tasksList tasks (supports filters)POST/tasksCreate taskGET/tasks/{id}Get single taskPUT/tasks/{id}Update taskDELETE/tasks/{id}Delete taskGET/filter-optionsAvailable 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

# 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: benoitjadinon
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-06T08:17:06.022Z
- Expires at: 2026-05-13T08:17:06.022Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/obsidian-plugin-tasknotes)
- [Send to Agent page](https://openagent3.xyz/skills/obsidian-plugin-tasknotes/agent)
- [JSON manifest](https://openagent3.xyz/skills/obsidian-plugin-tasknotes/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/obsidian-plugin-tasknotes/agent.md)
- [Download page](https://openagent3.xyz/downloads/obsidian-plugin-tasknotes)