“用于在思源任务笔记管理插件中管理任务、任务提醒和分类的 MCP 工具。”

— description from SKILL.md by Achuan-2
AGPL-3.0Auto-check passed

Install Task

skills CLI
$ npx skills add Achuan-2/siyuan-plugin-task-note-management --skill task -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Achuan-2/siyuan-plugin-task-note-management task --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Achuan-2/siyuan-plugin-task-note-management.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/task .claude/skills/task && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
task
GitHub stars
222
Token cost
~1.4k tokens
SKILL.md length
402 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
AGPL-3.0

At a glance

  • Works in 7 steps: search_task → get_task → create_task → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Task is a skill in Achuan-2/siyuan-plugin-task-note-management (222 stars). Its SKILL.md is about 1.4k tokens. Licence: AGPL-3.0.

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. search_task
  2. get_task
  3. create_task
  4. create_tasks
  5. update_task
  6. delete_task
  7. list_categories

What it can do on your machine

Read from SKILL.md and the folder at commit d4ed5fd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Task loads about 1.4k tokens when it runs. Until then it costs about 10 tokens; SKILL.md has 402 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~10
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Achuan-2/siyuan-plugin-task-note-management at commit d4ed5fd, republished under its AGPL-3.0 licence (© Achuan-2). 402 words, ~1,428 tokens.

Download SKILL.mdSave it as .claude/skills/task/SKILL.md (or your agent's skills folder).
name
task
description
用于在思源任务笔记管理插件中管理任务、任务提醒和分类的 MCP 工具。

任务管理技能 (task)

1. search_task

根据关键字、ID、项目、日期等条件搜索任务。

注意:为了节省 token 消耗,如果在搜索中指定了日期过滤(如传入了 date),repeat.instances 字段在搜索结果中将仅保留该日期范围的实例数据;如果不指定日期过滤,则会完全隐藏 repeat.instances 字段。要获取非查询日期的完整实例详情,请使用 get_task 接口。

  • keyword (字符串, 可选): 搜索关键字,匹配任务标题或备注内容。
  • id (字符串, 可选): 任务 ID,精确匹配。
  • projectId (字符串, 可选): 所属项目 ID。
  • date (字符串, 可选): 过滤日期 YYYY-MM-DD。可以传入 "today" 字符串,这将自动计算今日日期,并拉取今日任务、过期未完成任务、每日可做任务(效果和前端 Reminder 面板一致)。
  • priority (字符串, 可选): 优先级 ("high", "medium", "low", "none")。
  • status (字符串, 可选): 看板状态。
  • completed (布尔值, 可选): 是否已完成。
  • limit (数字, 可选): 返回数量上限,默认为 50。
2. get_task

根据任务 ID(或重复实例 ID)获取单个任务的详情。

  • 对于重复任务,支持传入 date 参数(或直接传入 taskID_YYYY-MM-DD 格式的实例 ID)来获取该特定日期实例的具体数据(如该日期的已完成状态、完成时间等)。
  • 如果不传 date(且 ID 无日期后缀),则返回包含完整 repeat.instances 重复实例详情的原始任务数据。
  • id (字符串, 必填): 任务 ID 或实例 ID。
  • date (字符串, 可选): 指定重复任务实例的具体日期 YYYY-MM-DD。
3. create_task

创建单个新任务。传入已有任务的 parentId 时,新任务会作为该任务的子任务创建。

  • title (字符串, 必填): 任务标题。
  • date (字符串, 可选): 任务日期 YYYY-MM-DD。省略或传入 ""(空字符串)可创建无日期任务。
  • note (字符串, 可选): 备注信息。
  • time (字符串, 可选): 开始时间 HH:MM;设置后会在任务开始时刻提醒。
  • reminderTimes (对象数组, 可选): 一个或多个额外提醒时间。每项包含:
    • time (字符串, 必填): 提醒时刻。使用 HH:MM 表示任务日期范围内的该时刻;使用 YYYY-MM-DDTHH:MM 表示绝对提醒日期和时刻,可用于提前一天等场景。
    • endTime (字符串, 可选): 提醒结束时刻,格式同 time。
    • note (字符串, 可选): 仅用于本次提醒的附加备注。
    • 在 update_task 中传入空数组 [] 可清除全部额外提醒。
  • endDate (字符串, 可选): 结束日期 YYYY-MM-DD。
  • endTime (字符串, 可选): 结束时间 HH:MM。
  • priority (字符串, 可选): 优先级 ("high", "medium", "low", "none")。
  • projectId (字符串, 可选): 项目 ID。
  • categoryId (字符串, 可选): 分类 ID。
  • parentId (字符串, 可选): 已有父任务的 ID。传入后会创建单个子任务;支持普通任务 ID 和 任务ID_YYYY-MM-DD 格式的重复任务实例 ID。父任务不存在或属于订阅任务时不会创建。
  • completed (布尔值, 可选): 是否完成,默认为 false。
  • blockId (字符串, 可选): 绑定的思源块 ID。设置后会自动获取并关联文档 ID,并在思源中同步块属性与书签。
  • url (字符串, 可选): 网页链接。
  • kanbanStatus (字符串, 可选): 看板状态。如果任务绑定了项目,所设看板状态必须是该项目已配置的看板状态(可以通过 get_project 或 list_columns 查询该项目的看板配置)。如果未绑定项目,必须是系统默认的看板状态之一。如果设置为 "completed" 且 completed 未显式传入,会自动将任务标记为已完成。
  • customProgress (数字, 可选): 自定义进度条百分比,取值范围为 0 到 100 的整数。
  • linkedHabitId (字符串, 可选): 绑定的习惯 ID。可以通过 habit 相关的工具查询习惯列表来获取此 ID。
  • linkedHabitSyncPomodoroToday (布尔值, 可选): 是否同步今日的番茄钟数据到绑定的习惯(必须在 linkedHabitId 设置时才生效)。
  • linkedHabitAutoCheckInOnComplete (布尔值, 可选): 任务完成时是否自动为关联的习惯打卡(必须在 linkedHabitId 设置时才生效)。
  • linkedHabitAutoCheckInOptionKey (字符串, 可选): 自动打卡习惯时的选项 Key。
  • linkedHabitAutoCheckInEmoji (字符串, 可选): 自动打卡习惯时的 Emoji。
  • repeat (对象, 可选): 重复周期性任务配置。注意:如果启用了重复配置(enabled 为 true),但是开始日期 date 传入了 ""(空字符串),系统会自动将其默认设置为今日本地日期。 属性如下:
    • enabled (布尔值, 必填): 是否启用。
    • type (字符串, 必填): 重复类型,支持 "daily" (每日), "weekly" (每周), "monthly" (每月), "yearly" (每年), "custom" (自定义), "ebbinghaus" (艾宾浩斯), "lunar-monthly" (农历每月), "lunar-yearly" (农历每年)。
    • interval (数字, 可选): 重复周期间隔。
    • weekDays (数字数组, 可选): 每周的哪几天 (0-6, 0为周日)。
    • monthDays (数字数组, 可选): 每月的哪几天 (1-31)。
    • monthlyRepeatMode (字符串, 可选): 每月重复类型 ("date" 按日期 / "week" 按星期)。
    • endDate (字符串, 可选): 重复截止日期 YYYY-MM-DD。
    • endType (字符串, 必填): 结束条件,支持 "never" (从不结束), "date" (截止到特定日期), "count" (限次数)。
    • endCount (数字, 可选): 限制重复的总次数。
    • reminderSkipWeekendMode (字符串, 可选): 跳过周末选项 ("none", "skip", "only_weekend")。
    • reminderSkipHolidays (布尔值, 可选): 是否跳过法定节假日。
Show full SKILL.md (76 more words)Show less
4. create_tasks

批量创建任务或批量给已有任务创建同级子任务。

  • tasks (对象数组, 必填): 要创建的任务列表,不能为空。每项都必须包含 title,并支持 create_task 的任务数据属性,例如日期、时间、额外提醒、优先级、项目、分类、重复设置、绑定块、网页链接、看板状态、自定义进度和习惯联动等;不在列表项中嵌套 parentId 或其他任务列表。
  • parentId (字符串, 可选): 不传时批量创建普通任务;传入已有任务 ID 时,tasks 中的所有任务都会成为该任务的同级子任务。支持重复任务实例 ID;子任务省略日期时会继承该实例日期。
  • projectId (字符串, 可选): 所有列表项的公共默认项目。任务项自己的 projectId 优先;两处都省略且传入了 parentId 时,继承父任务项目。
5. update_task

批量修改更新任务。

  • updates (对象数组, 必填): 更新项列表。每个对象必须包含:
    • id (字符串, 必填): 要修改的任务 ID。
    • 其他在 create_task 中支持的可更新参数 (包含 reminderTimes, blockId, url, kanbanStatus, customProgress, linkedHabitId 及打卡设置, repeat 对象等;不包含仅用于创建的 parentId 和 tasks)。
6. delete_task

删除任务.

  • id (字符串, 必填): 任务 ID。
7. list_categories

列出所有任务分类。

  • (无参数)

调用示例

获取今日及过期任务列表
json
{
  "action": "search_task",
  "date": "today"
}
创建一个高优先级的任务
json
{
  "action": "create_task",
  "title": "整理 MCP 工具技能说明文档",
  "date": "2026-07-11",
  "priority": "high",
  "note": "将 task、project、habit、stats 技能翻译为中文版"
}
创建任务并设置多个提醒
json
{
  "action": "create_task",
  "title": "提交周报",
  "date": "2026-07-11",
  "time": "17:00",
  "reminderTimes": [
    {
      "time": "2026-07-10T17:00",
      "note": "提前一天准备材料"
    },
    {
      "time": "16:30",
      "note": "提交前再次检查"
    }
  ]
}
给已有任务创建子任务
json
{
  "action": "create_task",
  "title": "补充接口测试",
  "parentId": "reminder_已有主任务ID"
}
批量创建普通任务
json
{
  "action": "create_tasks",
  "tasks": [
    {
      "title": "梳理接口输入",
      "priority": "high"
    },
    {
      "title": "补充接口测试",
      "date": "2026-07-12"
    },
    {
      "title": "更新使用文档"
    }
  ]
}
给已有任务批量创建同级子任务
json
{
  "action": "create_tasks",
  "parentId": "reminder_已有主任务ID",
  "tasks": [
    {
      "title": "梳理接口输入",
      "priority": "high"
    },
    {
      "title": "补充接口测试",
      "date": "2026-07-12"
    },
    {
      "title": "更新使用文档"
    }
  ]
}
创建一个每周一、三、五重复的周期性任务
json
{
  "action": "create_task",
  "title": "部门例会汇报准备",
  "date": "2026-07-11",
  "priority": "medium",
  "repeat": {
    "enabled": true,
    "type": "weekly",
    "weekDays": [1, 3, 5],
    "endType": "never"
  }
}

© Achuan-2, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/task of Achuan-2/siyuan-plugin-task-note-management.

Open the folder on GitHubat commit d4ed5fd

Compare with similar skills

Task next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Task compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Task this skillAchuan-2/siyuan-plugin-task-note-management222—~1.4kAutomated safety check: PassAGPL-3.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills8.4k6 repos~3.2kAutomated safety check: NotesApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Stitch to Remotion Walkthrough Videos

    google-labs-code/stitch-skills

    Official

    Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.

    8.4k GitHub starsUsed in 6 repos~3.2k tokens
    Media & CreativeAuto-check: notes
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed

More from Achuan-2/siyuan-plugin-task-note-management

  • Stats

    Achuan-2/siyuan-plugin-task-note-management

    用于在思源任务笔记管理插件中记录番茄钟专注记录和提取任务习惯统计摘要的 MCP 工具. An agent skill from Achuan-2/siyuan-plugin-task-note-management.

    222 GitHub stars~438 tokensUpdated today
    Auto-check passed
  • Habit

    Achuan-2/siyuan-plugin-task-note-management

    用于在思源任务笔记管理插件中管理习惯和日常打卡记录的 MCP 工具。

    222 GitHub stars~531 tokensUpdated today
    Auto-check passed
  • Project

    Achuan-2/siyuan-plugin-task-note-management

    用于在思源任务笔记管理插件中管理项目看板及文件夹分组的 MCP 工具。

    222 GitHub stars~567 tokensUpdated today
    Auto-check passed
  • Task Note Management MCP

    Achuan-2/siyuan-plugin-task-note-management

    思源任务笔记管理插件 MCP 工具总览技能。

    222 GitHub stars~311 tokensUpdated today
    Auto-check passed

Questions about Task

How do I install Task in Claude Code?

Run `npx skills add Achuan-2/siyuan-plugin-task-note-management --skill task -a claude-code`. Or copy the skill folder (skills/task in Achuan-2/siyuan-plugin-task-note-management) into .claude/skills/task in your project. Claude Code loads it when a task matches its description.

How do I install Task in Codex?

Run `npx skills add Achuan-2/siyuan-plugin-task-note-management --skill task -a codex`. Or copy the skill folder (skills/task in Achuan-2/siyuan-plugin-task-note-management) into .agents/skills/task in your project. Codex loads it when a task matches its description.

Can I use Task in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Achuan-2/siyuan-plugin-task-note-management --skill task -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/task, .gemini/skills/task, .github/skills/task and .opencode/skills/task in your project.

What does Task need to run?

SKILL.md names no scripts, command-line tools or credentials: Task is instructions for the agent only.

Does Task access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Task safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Task use?

Task is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Task use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Task?

Skills that share tags, products or a category with Task: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Task?

Achuan-2 (a GitHub user) maintains it in Achuan-2/siyuan-plugin-task-note-management, which has 222 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 9, 2026.

Source: Achuan-2/siyuan-plugin-task-note-management on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.