Obsidian CLI Skills for Codex

Codex-native skills for driving the Obsidian CLI across common vault workflows.

This repo mirrors the domain split from the earlier Claude-oriented design, but packages the work as Codex skills instead of a Claude plugin. The current v1 scope covers 10 skills:

• obsidian-vault
• obsidian-notes
• obsidian-search
• obsidian-daily
• obsidian-tasks
• obsidian-tags
• obsidian-bookmarks
• obsidian-templates
• obsidian-plugins
• obsidian-ui

Requirements

• Obsidian desktop app with CLI support enabled
• Obsidian CLI available in PATH
• A runtime where the local obsidian command can talk to the desktop app
• Python 3 for skill validation
• Bash for smoke tests

The official CLI docs note that the desktop app must be running and that vault=<name> must appear before the command when explicitly targeting a vault.

Repo Layout

skills/                  Codex skill folders
docs/                    Maintainer documentation and coverage notes
scripts/                 Validation helpers
tests/                   Smoke test and manual checklist

Using the Skills

For normal Codex discovery, place or symlink individual skill folders under:

${CODEX_HOME:-$HOME/.codex}/skills/

During development, you can also invoke a skill by path.

Examples:

Use $obsidian-tasks to list open tasks from my work vault.
Use $obsidian-search to find notes mentioning "meeting retro".
Use $obsidian-daily to append "- [ ] Review release checklist" to today's daily note.
Use $obsidian-vault to inspect sync history for file=Roadmap.

Validation and Testing

Validate skill metadata and structure:

./scripts/validate-skills.sh

Run non-destructive smoke tests against a live Obsidian environment:

./tests/smoke-test.sh
./tests/smoke-test.sh vault="My Vault"

See tests/README.md for the manual checklist covering destructive or stateful commands.

Documentation

• docs/codex-spec.md
• docs/codex-implementation-plan.md
• docs/command-coverage.md