Agent skill

Obsidian Todo Collector

by cafe3310 in cafe3310/public-agent-skills

从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills.

Apache-2.0Auto-check passed

Install Obsidian Todo Collector

skills CLI
$ npx skills add cafe3310/public-agent-skills --skill obsidian-todo-collector -a claude-code

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

GitHub CLI
$ gh skill install cafe3310/public-agent-skills obsidian-todo-collector --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/cafe3310/public-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills_parked/obsidian-todo-collector .claude/skills/obsidian-todo-collector && 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
obsidian-todo-collector
GitHub stars
255
Token cost
~575 tokens
SKILL.md length
93 words
Files
4 (incl. scripts, references)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills.

  • SKILL.md covers 处理流程 and 编写要求
  • Runs Python scripts from its folder

What it does

Obsidian Todo Collector is an agent skill from cafe3310/public-agent-skills. 从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `HUMAN_GUIDE.md`, `references/original_instructions.md` and `scripts/pre_check.py`).

It works with Obsidian. The repository describes itself as: personal agent skills for better QoL. The licence is Apache-2.0.

Example prompts

  • “/obsidian-todo-collector”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 6c45501. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    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

Obsidian Todo Collector loads about 575 tokens when it runs, and up to ~1.4k if it reads all its reference files. Until then it costs about 17 tokens; SKILL.md has 93 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~575
With references · SKILL.md plus every file in references/, read only if the agent opens them
~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); the scripts in this folder are not scanned.

SKILL.md

The full file from cafe3310/public-agent-skills at commit 6c45501, republished under its Apache-2.0 licence (© cafe3310). 93 words, ~575 tokens.

Download SKILL.mdSave it as .claude/skills/obsidian-todo-collector/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
obsidian-todo-collector
description
从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档
license
Apache-2.0
author
github/cafe3310
depends_on_binary
python3

Obsidian 未完成事件整理

此技能用于在指定时间范围内,从 Obsidian 笔记中提取并汇总所有未完成的事件和规划性事项,生成一个统一的「未完成事件整理」文档,便于后续跟踪和管理。

处理流程

按照以下步骤执行:

步骤1 - 确定范围与目标
  • 输入:用户指定的时间范围。仓库文档文件名前面必然是 YYYY-MM-DD(-hh),可以以通过文件名来筛选出指定时间范围内的文档。
  • 目标文档:新建名为 YYYY-MM-DD-HH 📅 未完成事件整理.md 的文档。该文档的结构是
md
## 文档生成说明
- 生成原因:整理指定时间范围内的未完成事件,便于后续跟踪和管理。
- 时间范围:{{时间范围}}

## 当前状态
所有待处理文档列表:
- [ ] {{待处理文档列表,每个文档使用 [[文件名]] 链接,处理完成后更新为已完成 [x] 状态}}

## 未完成事件列表
{{未完成事件列表,每个都是 ### 🟥 名称。若已经完成,则更新为 ### 🟩 名称}}

## 未完成规划性事项列表
{{未完成规划性事项列表,每个都是 ### 🟥 名称,若已经完成,则更新为 ### 🟩 名称}}

当前状态部分要在下面的循环中实时更新,显示已经处理到哪个日期的文档,以及剩余待处理的文档列表。

其中,「未完成事件」和「未完成规划性事项」的每一项都使用三级标题(###)进行标注,便于在文档中清晰展示。

「未完成事件」指的是具体工作,包括计划的、正在进行中的、未完成的任务。每个事件都应该包含以下信息:

  • 名称
  • 出现在哪些文档(可能是多份文档列表)
  • 当前状态

「未完成规划性事项」指的是更加抽象的规划性事项,例如项目规划、战略规划等,虽然没有具体的截止日期,但仍然需要跟踪和管理。每个规划性事项也应该包含以下信息:

  • 名称
  • 出现在哪些文档(可能是多份文档列表)
  • 当前状态
步骤2 - 处理主循环

执行下列循环,以依次处理「未完成事件整理」文档「当前状态」中的每个文档:

步骤2.1. 确定当前批次的「当前文档」:从未完成处理的文档中取出一批,每批最多 3 个文件。

步骤2.2. 预检该批文档:使用 Skill 提供的 Python 脚本进行预检,确保文档符合处理条件。 bash python3 scripts/pre_check.py [file] ... --lines 15

步骤2.3. 通过上述命令的结果,判断 - 文档是否属于「文档摘录」,「语音转写」这两种 - 或文档是否太大(超过 64KB)或太长(超过 1000 行) 如果是,使用 Ask User,询问用户是否跳过(默认选项是跳过)。 如果用户选择跳过,进入下一个文档的处理。

步骤2.4. 阅读文档全文。关注以下内容: - 是否包含未完成事件或工作(尤其是以 🟥 标记的未完成事项)。 - 是否包含未完成规划性事项(尤其是以 🟥 标记的未完成规划性事项)。 - 如果包含,提取相关信息(事情描述;出现的文档;当前状态),并将其添加到「未完成事件整理」文档的相应部分。无须过度处理信息,保持原文的描述即可。 - 如果文档中提及的事项显然已经完成(例如,以 🟩 标记),则更新「未完成事件整理」文档中该事项的状态为完成(🟩)。如果不确定是否完成,可以保留原状态(🟥),以便后续跟踪。

步骤2.5. 对「未完成事件整理」文档用多次批量编辑的方式,更新 未完成事件列表 和 未完成规划性事项列表,并编辑状态有更新的事项。注意,必须要更新待办事项部分。

步骤2.6. 在更新了待办事项之后,更新「未完成事件整理」文档的「当前状态」部分,给已经处理完成的文档打已完成 [x] 。这样可以清晰地知道已经处理了哪些文档,哪些文档还未处理。

步骤2.7. 跳回 步骤2.1(确定当前批次的「当前文档」),继续处理下一批文档,直到处理完指定时间范围内的所有文档。

编写要求

  • 描述平实、清晰、直接。尽量摘录原始内容,保持原汁原味。
  • 用链接 [[target-doc]] 引用来源,确保可追溯性。
  • 编辑文件的时候,用多次批量 replace 工具进行增量更新,禁止使用 write_file 全量覆盖,以确保不会误删之前已经记录的内容。
  • 编辑文件时,倾向于「追加更新」而不是修改已有内容。我会自己判断每个事项的最终状态。
  • 对于「未完成事件整理」文档,在你不确定内容时,尽量先读再写。我会在合适时机 compress 或断点续传,你无须节省 token。
  • 如果断点续传,在读取「未完成事件整理」的全文之后,直接从「处理主循环」开始。
  • 必须在每一批文件处理后,更新文档中的待办和规划待办。不要提前看下一批文件,即使内容相关。你必须按照批次处理,逐步更新文档。

© cafe3310, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills_parked/obsidian-todo-collector of cafe3310/public-agent-skills.

  • SKILL.md
  • HUMAN_GUIDE.md
  • references/original_instructions.md
  • scripts/pre_check.py

Open the folder on GitHubat commit 6c45501

Compare with similar skills

Obsidian Todo Collector 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.

Obsidian Todo Collector compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian Todo Collector this skillcafe3310/public-agent-skills255—~575Automated safety check: PassApache-2.0
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0

Similar skills

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed
  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed
  • Obsidian Canvas Creator

    axtonliu/axton-obsidian-visual-skills

    Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts.

    3.6k GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed

More from cafe3310/public-agent-skills

All 29 skills in this repo
  • Impeccable

    cafe3310/public-agent-skills

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    255 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Text Watermark Fountain

    cafe3310/public-agent-skills

    A specialized skill for embedding and extracting resilient watermarks in text by manipulating sentence lengths and using Fountain Codes.

    255 GitHub stars~921 tokensUpdated 3 mo ago
    Auto-check passed
  • Deep Research

    cafe3310/public-agent-skills

    一个全面、自主的深度研究框架。当用户请求对复杂主题、市场调研、技术格局进行深入的多维度调查,或需要大量网页浏览、数据合成和结构化报告的任何任务时,使用此技能。它协调子代理(subagents)并使用基于文件系统的状态管理来防止上下文膨胀。

    255 GitHub stars~996 tokensUpdated 3 mo ago
    Auto-check passed
  • Long Audio To Obsidian

    cafe3310/public-agent-skills

    将语音转写项目输出的复杂文件结构整理合并为适合 Obsidian 归档的 Markdown 文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~772 tokensUpdated 3 mo ago
    Auto-check passed
  • Markdown New

    cafe3310/public-agent-skills

    通过 markdown.new API 将网页、整站或搜索结果转换为干净的 Markdown. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~344 tokensUpdated 3 mo ago
    Auto-check passed
  • Oneshot Website

    cafe3310/public-agent-skills

    Generate immersive, one-shot single-file HTML websites with embedded CSS and JS.

    255 GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Obsidian Todo Collector

What does Obsidian Todo Collector do?

从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills. Obsidian Todo Collector is an agent skill from cafe3310/public-agent-skills.

How do I install Obsidian Todo Collector in Claude Code?

Run `npx skills add cafe3310/public-agent-skills --skill obsidian-todo-collector -a claude-code`. Or copy the skill folder (skills_parked/obsidian-todo-collector in cafe3310/public-agent-skills) into .claude/skills/obsidian-todo-collector in your project. Claude Code loads it when a task matches its description.

How do I install Obsidian Todo Collector in Codex?

Run `npx skills add cafe3310/public-agent-skills --skill obsidian-todo-collector -a codex`. Or copy the skill folder (skills_parked/obsidian-todo-collector in cafe3310/public-agent-skills) into .agents/skills/obsidian-todo-collector in your project. Codex loads it when a task matches its description.

Can I use Obsidian Todo Collector 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 cafe3310/public-agent-skills --skill obsidian-todo-collector -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/obsidian-todo-collector, .gemini/skills/obsidian-todo-collector, .github/skills/obsidian-todo-collector and .opencode/skills/obsidian-todo-collector in your project.

What does Obsidian Todo Collector need to run?

Going by SKILL.md and its folder, Obsidian Todo Collector needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Obsidian Todo Collector 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 Obsidian Todo Collector 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Obsidian Todo Collector use?

Obsidian Todo Collector is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Obsidian Todo Collector use?

About 575 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 874 tokens, read only when the agent opens those files.

What are the alternatives to Obsidian Todo Collector?

Skills that share tags, products or a category with Obsidian Todo Collector: Obsidian Bases (Atmosphere/atmosphere, 3.8k stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars) and Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian Todo Collector?

cafe3310 (a GitHub user) maintains it in cafe3310/public-agent-skills, which has 255 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on June 26, 2026.

Source: cafe3310/public-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.