这是一个 Agent Skills 的市场（marketplace），用来收纳各类 skill。市场是顶层容器，按插件（plugin）组织内容：市场登记若干插件，每个插件聚焦一个领域、自带一个或多个 skill，而每个 skill 都符合通用的 Agent Skills 规范。目前市场里主要是 obsidian 插件，它借助官方 obsidian 命令行工具操作 Obsidian vault；随着收录范围扩大，面向其他领域的插件会陆续加入。
市场与插件这套层级是 Claude Code 专有的机制，因此本仓库可以作为插件市场直接装进 Claude Code。同时，因为每个插件 skills/ 目录下的 skill 都是通用格式，它们也能脱离市场单独手动装进 Codex CLI、OpenCode 等任何支持 Agent Skills 的 Agent；这些 Agent 不认识市场与插件，走下面的手动安装即可。
仓库内每个插件各占 plugins/ 下的一个子目录，自带 .claude-plugin/plugin.json 与 skills/；根目录的 .claude-plugin/marketplace.json 是市场清单，登记所有插件。下文以 obsidian 插件为例，它位于 plugins/obsidian/。
| Skill | 作用 |
|---|---|
obsidian-base-author |
编写与修改 .base 文件，为笔记建立数据库式视图，含筛选、公式、属性显示名、汇总与单视图布局。内置 Bases 语法与函数的完整参考，以及命名与单视图约定。 |
obsidian-base-query |
运行已有的 .base 取回结果，并在结果不符预期时解读、调试。只读，不修改任何笔记或 .base。 |
obsidian-search |
只读检索 vault，按关键词找笔记、搜文本、厘清结构，也可当作一处外部记忆来查既往的事实、决定与偏好。 |
当 query 发现需要的 base 还不存在时，它会自动转交给 author。
这些 skill 都依赖 Obsidian 自带的命令行工具：Obsidian 1.12.7 及以上，并已在 Settings → General → Command line interface 启用 CLI（一次性注册后会生成 obsidian 命令）。若命令报「command not found」，说明 CLI 尚未注册，skill 会如实报告而不绕路。
命令依赖 Obsidian 应用运行，但不必手动先开；首条命令会自动把它启动起来，可能略有延迟。
通过插件市场（plugin marketplace）安装，在 Claude Code 中执行：
/plugin marketplace add 21noises/agent-skills
/plugin install obsidian@21noises
安装后执行 /reload-plugins 加载 skill。
也可以在本地直接试用，无须安装：
claude --plugin-dir /path/to/agent-skills/plugins/obsidian
不走市场也行，直接把 skill 目录放进 Claude Code 的 skills 目录即可。装到个人全局，对所有项目生效：
git clone https://github.com/21noises/agent-skills.git
cp -R agent-skills/plugins/obsidian/skills/* ~/.claude/skills/
只想给某个 vault 用，就放进该 vault 根目录下的 .claude/skills/：
cp -R agent-skills/plugins/obsidian/skills/* /path/to/vault/.claude/skills/
手动安装的 skill 不带插件命名空间前缀，调用时直接用 /obsidian-search 这样的原始名。
每个插件 skills/ 目录下的子目录都是一份标准的 Agent Skill（SKILL.md 加 references/），把它们放进对应 Agent 的 skills 目录即可，无须任何转换：
| Agent | skills 目录 |
|---|---|
| Codex CLI | ~/.codex/skills/ |
| OpenCode | ~/.opencode/skills/ |
以 Codex CLI 为例：
git clone https://github.com/21noises/agent-skills.git
cp -R agent-skills/plugins/obsidian/skills/* ~/.codex/skills/
复制时务必保留每个 skill 目录的完整结构，obsidian-base-author 的 references/ 子目录不能丢，否则它查不到内置的语法与函数参考。allowed-tools、argument-hint 这些字段是 Claude 专有的，不识别它们的 Agent 会直接忽略，不影响 skill 工作。
调用名取决于安装方式。通过插件市场安装时，要加上插件命名空间前缀，也就是插件名加 skill 名：
/obsidian:obsidian-base-author
/obsidian:obsidian-base-query
/obsidian:obsidian-search
手动安装（直接放进 skills 目录）的则不带前缀，用原始名即可：
/obsidian-base-author
/obsidian-base-query
/obsidian-search
obsidian-search 不止能搜当前打开的库。把 vault 名作为第一个参数传入、后面接查询内容，它就直接去那个 vault 里搜，无须你先在 Obsidian 里切换当前库：
/obsidian-search 工作 上周的会议纪要
上例在名为「工作」的 vault 里搜「上周的会议纪要」。省去开头的 vault 名，则在当前活跃的 vault 里搜。
MIT，见 LICENSE。