Agent skill

Obsidian Knowledge Filter

by cafe3310 in cafe3310/public-agent-skills

“从知识库目录中检索、筛选和提取特定关键词相关知识”

— description from SKILL.md by cafe3310
Apache-2.0Auto-check passed

Install Obsidian Knowledge Filter

skills CLI
$ npx skills add cafe3310/public-agent-skills --skill obsidian-knowledge-filter -a claude-code

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

GitHub CLI
$ gh skill install cafe3310/public-agent-skills obsidian-knowledge-filter --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-knowledge-filter .claude/skills/obsidian-knowledge-filter && 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-knowledge-filter
GitHub stars
255
Token cost
~705 tokens
SKILL.md length
173 words
Files
3 (incl. scripts)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Works in 4 steps: 分块读取: Agent 以 1000 行为单位,逐块读取… → 综合分析: 针对刚才读取的 整个内容块(其中可能包含多个文件片段),Agent… → 单次写入: Agent 将 2 产生的分析洞察,一次性地追加写入到… → …
  • SKILL.md covers 描述, 何时使用 and 工作流程
  • Runs Python scripts from its folder

About this skill

Obsidian Knowledge Filter is a skill in cafe3310/public-agent-skills (255 stars). Its SKILL.md is about 705 tokens, with 2 other files in the folder (scripts). Licence: Apache-2.0.

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 分块读取: Agent 以 1000 行为单位,逐块读取 002_content.yaml 文件;例如,第一次会读取 1-1000 行。
  2. 综合分析: 针对刚才读取的 整个内容块(其中可能包含多个文件片段),Agent 在内部进行一次性综合分析,提炼出所有与用户任务相关的洞察、观点和联系。
  3. 单次写入: Agent 将 2 产生的分析洞察,一次性地追加写入到 003_content_analysis.md 文件中,清晰地标注每个洞察来源于哪个文件。
  4. 循环执行: 跳到 1 继续下一块,直到处理完所有内容块。

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 2 files 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 Knowledge Filter loads about 705 tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 173 words of instructions outside code blocks.

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

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). 173 words, ~705 tokens.

Download SKILL.mdSave it as .claude/skills/obsidian-knowledge-filter/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
obsidian-knowledge-filter
description
从知识库目录中检索、筛选和提取特定关键词相关知识
license
Apache-2.0
author
github/cafe3310
depends_on_binary
python3

技能: Obsidian 知识筛选器 (Obsidian Knowledge Filter)

描述

此技能旨在从由大量 Markdown 文件组成的知识库(例如 Obsidian Vault)中,通过一个精确且分阶段的工作流,进行知识的检索、筛选和提取。它采用带编号前缀的 YAML 和 Markdown 文件来管理每一步的中间数据,并在每个关键步骤暂停以供用户审阅,确保最终产出的内容高度相关且无重复。

核心理念: 此技能的目标是在用户的指导下,通过一系列独立的脚本和分析步骤,精确地从知识库中提炼与特定主题相关的信息,并通过结构化的方式呈现,最终形成综合分析报告。

何时使用

当用户请求您通过查找、关联和综合分散在个人知识库中的信息来解决复杂问题时,请使用此技能。此工作流特别适用于需要高精度、希望减少冗余信息并全程参与筛选过程的场景。

工作流程

该过程分为四个主要阶段,每个阶段都以用户审阅为节点。

阶段 1: 关键词搜索与分析
步骤 1.1: 运行分析脚本 001_analyze_files.py

此脚本递归地在指定目录中搜索所有 .md 文件,并执行以下操作:

  • 文件排除: 自动跳过任何路径中包含 tmp-, _attachments, 或 .trash 的文件/目录。

  • 关键词分析: 查找包含指定关键词的文件,记录每个关键词的出现频率。

  • 上下文合并: 将包含关键词的行的上下文(默认为前后 10 行)合并成连续的行号区间。

  • 输出: 在一个新建的 tmp-YYYY-MM-DD-HH-MM-SS-analysis/ 临时目录中,生成 001_analysis.yaml。


001_analysis.yaml 格式详解: 这是一个 YAML 文件,包含一个文件信息对象的列表。每个对象都具有以下结构:

yaml
- file_path: '文件夹/2025-12-29-示例文件.md'  # 相对于当前工作目录的路径
  keyword_counts:
    - word: '关键词1'
      count: 5
    - word: '关键词2'
      count: 2
  line_ranges:
    - [10, 30]   # 第一个内容提取区间
    - [45, 65]   # 第二个内容提取区间

步骤 1.2: 用户审阅分析文件

Agent 暂停并请求用户审阅 001_analysis.yaml,用户可手动编辑此文件以增删文件或修改行号区间。

阶段 2: 内容提取与清理
步骤 2.1: 运行提取脚本 002_extract_content.py

用户确认后,此脚本会读取 001_analysis.yaml,并根据其中的 file_path 和 line_ranges 提取相应的内容。

  • 内容清理: 在提取内容后,脚本会执行以下三项自动清理:

    1. 合并换行: 将连续的多个换行符合并为一个。
    2. 移除加粗: 删除所有的 Markdown 加粗标记 (**)。
    3. 移除图片: 删除所有的 Markdown 图片链接 (![[...]])。
  • 输出: 在同一个临时目录中,生成 002_content.yaml,其结构与 001_analysis.yaml 类似,但每个对象都增加了一个 content 字段。


002_content.yaml 格式详解:

yaml
- file_path: '文件夹/2025-12-29-示例文件.md'
  keyword_counts:
    # ... (同上)
  line_ranges:
    # ... (同上)
  content: "这是从文件中提取并清理后的文本内容...\n..."

步骤 2.2: 用户审阅内容文件

Agent 再次暂停,请求用户审阅 002_content.yaml,确保提取和清理后的内容符合预期。

阶段 3: 内容洞察综合
步骤 3.1: Agent 进行分块综合分析

用户确认后,Agent 开始对 002_content.yaml 进行智能分析。为提升效率并保证分析的连贯性,Agent 采用分块「读取-分析-写出」循环模式:

  1. 分块读取: Agent 以 1000 行为单位,逐块读取 002_content.yaml 文件;例如,第一次会读取 1-1000 行。
  2. 综合分析: 针对刚才读取的 整个内容块(其中可能包含多个文件片段),Agent 在内部进行一次性综合分析,提炼出所有与用户任务相关的洞察、观点和联系。
  3. 单次写入: Agent 将 2 产生的分析洞察,一次性地追加写入到 003_content_analysis.md 文件中,清晰地标注每个洞察来源于哪个文件。
  4. 循环执行: 跳到 1 继续下一块,直到处理完所有内容块。

这种方法避免了逐条分析的低效与碎片化,确保了分析过程的流畅性和上下文关联性。

  • 输出: 003_content_analysis.md,其中包含了对所有文件片段的综合洞察。
步骤 3.2: 用户审阅洞察文件

Agent 完成所有内容块的分析后,暂停并请求用户审阅最终生成的 003_content_analysis.md,确认洞察的准确性和深度。

阶段 4: 最终报告合成
步骤 4.1: Agent 生成最终报告

在用户完成最终审阅后,Agent 将以 003_content_analysis.md 为素材,撰写一份逻辑连贯、结构清晰的最终报告。

  • 输出: 004_report.md
步骤 4.2: 提交结果

Agent 向用户提交最终的 04_report.md 报告。

© 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 2 other files (scripts) in skills_parked/obsidian-knowledge-filter of cafe3310/public-agent-skills.

  • SKILL.md
  • scripts/001_analyze_files.py
  • scripts/002_extract_content.py

Open the folder on GitHubat commit 6c45501

Compare with similar skills

Obsidian Knowledge Filter 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 Knowledge Filter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian Knowledge Filter this skillcafe3310/public-agent-skills255—~705Automated 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
Bounded AutoresearchAgriciDaniel/claude-obsidian15k1 repos~1.6kAutomated safety check: PassMIT

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
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub starsUsed in 1 repo~1.6k tokens
    Knowledge ManagementAuto-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

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

    cafe3310/public-agent-skills

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

    255 GitHub stars~575 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

Works with

Questions about Obsidian Knowledge Filter

How do I install Obsidian Knowledge Filter in Claude Code?

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

How do I install Obsidian Knowledge Filter in Codex?

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

Can I use Obsidian Knowledge Filter 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-knowledge-filter -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-knowledge-filter, .gemini/skills/obsidian-knowledge-filter, .github/skills/obsidian-knowledge-filter and .opencode/skills/obsidian-knowledge-filter in your project.

What does Obsidian Knowledge Filter need to run?

Going by SKILL.md and its folder, Obsidian Knowledge Filter needs Python for the scripts in its folder.

Does Obsidian Knowledge Filter 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 Knowledge Filter 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 Knowledge Filter use?

Obsidian Knowledge Filter 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 Knowledge Filter use?

About 705 tokens (SKILL.md is roughly 2.8k 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 Obsidian Knowledge Filter?

Skills that share tags, products or a category with Obsidian Knowledge Filter: 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 Knowledge Filter?

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.