Obsidian Agent Skills — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Obsidian Agent Skills (Plugin) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Obsidian-backed skills 集合，用于 agent 项目记忆、任务收尾、ADR、经验沉淀和知识整理。
本仓库遵循 Agent Skills specification。Claude Code、Codex、OpenCode 以及其他能发现 skills/<skill-name>/SKILL.md 的客户端都可以安装使用。
仓库内 memory 和 ADR 功能可以只依赖本项目文件；涉及 Obsidian vault 的功能需要额外准备运行中的 Obsidian：
设置 -> 关于 -> 高级，开启 命令行界面。obsidian help 验证 CLI 可用，再运行 obsidian vault 确认能访问目标 vault。$obinit 同步 Agent/Projects/、$oblearn 写入 Agent/Knowledge/、$obcurate 整理公共知识库时都需要上述前提。构建、测试和发布本仓库不依赖 Obsidian。
Codex：
codex plugin marketplace add GeekXtop/obsidian-agent-skills
codex plugin add obsidian-agent-skills@obsidian-agent-skillsClaude Code：
claude plugin marketplace add GeekXtop/obsidian-agent-skills --scope user
claude plugin install obsidian-agent-skills@obsidian-agent-skills --scope user插件提供五个 skills：obinit、obadr、obclose、oblearn、obcurate。
插件同时提供对应命令入口；不同客户端可能显示为 slash command、prompt chip 或命令面板项：
/obinit
/obadr
/obclose
/oblearn
/obcuratenpx skills add https://github.com/GeekXtop/obsidian-agent-skills如果偏好 SSH：
npx skills add [email protected]:GeekXtop/obsidian-agent-skills.git#### Codex
把 skills/ 目录复制到 Codex skills 路径：
$CODEX_HOME/skills未设置 CODEX_HOME 时使用用户主目录下的 .codex/skills：Windows 通常是 %USERPROFILE%\.codex\skills，macOS/Linux 通常是 ~/.codex/skills。
#### Claude Code
把 skills/ 下的 skill 目录复制到 Claude skills 路径：
~/.claude/skills#### OpenCode
把完整仓库 clone 到 OpenCode skills 目录：
git clone https://github.com/GeekXtop/obsidian-agent-skills.git ~/.opencode/skills/obsidian-agent-skillsOpenCode 重启后会发现嵌套 skills/ 目录下的 SKILL.md。
已通过 marketplace 安装时，不要直接 clone、复制或改写客户端 cache。发布新版本后用对应客户端的插件管理命令更新。
发布 tag 只保留插件发布约定的 obsidian-agent-skills--vX.Y.Z。不要再为同一版本额外创建平行的 vX.Y.Z tag；已有历史 v0.1.x tag 保留为已发布引用。
Codex：
codex plugin marketplace upgrade obsidian-agent-skills
codex plugin add obsidian-agent-skills@obsidian-agent-skillsClaude Code：
claude plugin marketplace update obsidian-agent-skills
claude plugin update obsidian-agent-skills@obsidian-agent-skills --scope user更新后需要 reload 或重启：
/reload 或重启 Claude Code。可以用以下命令确认本地版本：
codex plugin list --json
claude plugin list --json| Skill | 说明 |
|---|---|
| obinit | 初始化或更新软件项目的 Obsidian-backed agent 工作约定。 |
| obadr | 把项目内长期架构决策记录到 docs/adr/。 |
| obclose | 在任务或会话收尾时更新项目 memory；实质任务结束后 agent 可主动执行，并控制 progress / lessons 膨胀。 |
| oblearn | 从项目内经验、非项目临时会话材料或 Codex session 提取跨场景可复用知识，并写入或建议写入 Obsidian 公共知识笔记。 |
| obcurate | 整理和维护 Agent/Knowledge/ 公共知识库、Inbox 和 _catalog.md。 |
显式要求 agent 使用某个 skill：
$obinit$obadr$obclose$oblearn$obcurate这些 skills 默认遵循用户或项目既有语言偏好；本仓库当前模板使用简体中文，fork 可替换 templates/ 调整输出语言。技术标识符、路径、命令、包名和英文专有名词保持原样。它们把 Obsidian 作为上下文和知识层，不把 Obsidian 变成构建、测试、部署或运行时依赖。
$obinit 会按项目状态选择模式：
.agents/instructions.md，AGENTS.md / CLAUDE.md 作为薄入口。AGENTS.md / CLAUDE.md，只追加中文入口提示；.agents/instructions.md 使用索引型结构，避免重复复制长规则。.agents/active.md、.agents/progress.md、.agents/lessons.md 等项目 memory 文件不会后台自动同步。需要 agent 在任务开始、阶段结束或会话收尾时主动回写；完成实质代码/文档改动、阶段性验证或复杂任务暂停时，agent 应按 $obclose 收尾。$obclose 还会检查 progress / lessons 是否过长或重复，必要时轻量合并、压缩或把旧进展归档到 .agents/archive/。
Agent/Knowledge/ 中的跨项目公共知识不会被全量自动加载。接入项目后，agent 不应凭空假设哪些领域已经沉淀；只有用户明确要求、Agent/Knowledge/_catalog.md 命中任务关键词，或风险较高且关键词明确时，才做有限关键词定向搜索。命中相关笔记后再明确读取并记录到当前项目的“已使用知识”或 Obsidian 项目笔记“相关知识”。
$oblearn 负责把当前项目经验提取为跨项目公共知识；项目内经验先由 $obclose 写入 .agents/lessons.md。它也支持非项目临时会话：当当前目录没有项目 memory，或用户明确要求从当前对话、粘贴 transcript、临时任务摘要、Codex session id 中提取经验时，不要求先 $obinit，不创建 .agents/，只把脱敏后的可复用经验写入或建议写入 Agent/Knowledge/Inbox/。Codex session id 只用于在本机 Codex 会话存储中精确定位对应 JSONL，不使用 codex resume 读取，也不扩大扫描无关历史。不确定归类的新知识可建议写入 Inbox，并在关键词明确时更新 _catalog.md。$obcurate 负责低频整理公共知识库，例如清理 Inbox、维护 _catalog.md、合并或拆分主题、修正 aliases/tags/wikilink。
模板文件位于各 skill 的 templates/ 目录。SKILL.md 定义行为和安全边界，模板定义写入项目或 Obsidian 的输出格式。
验证仓库：
npm test校验脚本会检查 skill frontmatter、OpenAI agent metadata、命令入口、模板语言回归规则，以及插件 manifest 版本一致性。
两个 plugin manifest 的 skills 发现方式不同，这是有意为之：.codex-plugin/plugin.json 用 "skills": "./skills/" 显式声明，.claude-plugin/plugin.json 依赖 Claude Code 对仓库根 skills/ 与 commands/ 目录的约定式发现，因此不重复声明。两者指向同一套 skills/，.claude-plugin/plugin.json 缺少 skills 字段不是配置遗漏。
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.