Skip to content

feat: add obsidian-vault plugin#1

Merged
aliasunder merged 11 commits into
mainfrom
feat/obsidian-vault-plugin
Apr 21, 2026
Merged

feat: add obsidian-vault plugin#1
aliasunder merged 11 commits into
mainfrom
feat/obsidian-vault-plugin

Conversation

@aliasunder
Copy link
Copy Markdown
Owner

obsidian-vault plugin

Adds the obsidian-vault plugin — an always-on Obsidian conventions skill for Claude Cowork vaults.

What it does

Keeps Claude's note editing consistent and safe across sessions. The skill activates automatically whenever Claude detects an Obsidian vault in the working directory. Core OFM conventions are always in context; detailed plugin syntax and property type rules load from reference files only when the task calls for them.

Files added

obsidian-vault/
├── .claude-plugin/plugin.json
├── README.md
└── skills/obsidian-vault/
    ├── SKILL.md                  # always-on orchestrator
    └── references/
        ├── syntax.md             # embeds, block refs, Mermaid, comments
        ├── plugins.md            # Dataview, Tasks, Templater, Bases, Canvas
        └── properties.md        # YAML types, reserved keys, schemas

.claude-plugin/marketplace.json updated to include the obsidian-vault entry at the current version (0.4.3).

TODOs before merge

  • Review SKILL.md trigger conditions
  • Review reference file coverage (Excalidraw, Obsidian Git, Kanban, Periodic Notes are natural next additions but out of scope for v1)
  • Bump version if needed before release

aliasunder and others added 11 commits April 18, 2026 14:28
… creation

Review pass on the draft plugin before merge:

- plugin.json: add author/repository/keywords to match trip-planner shape;
  reword description from "always-on" marketing language to accurately
  describe conditional activation on note creation/editing in a vault
- marketplace.json: mirror the new plugin.json description
- SKILL.md: add NOT-for clause to disambiguate non-vault .md work; reword
  detection hint so .obsidian/ can live in an ancestor (Cowork projects
  commonly sit as subdirectories inside a vault); rename "Safe Editing
  Rules" to "Safe Output Rules" and annotate edit-only items so the
  checklist applies to new-file creation too; add property-type
  consistency check; reword Canvas bullet to remove accidental refusal
  framing; strengthen recommended CLAUDE.md snippet to cover all .md
  output (notes, session logs, CLAUDE.md/TASKS.md)
- README.md: reframe lead and "What it does" to drop "always-on"; rename
  "What's always on" heading to "What the skill covers"; update CLAUDE.md
  snippet to match the SKILL.md version
Match the reworded descriptions now used in plugin.json and
marketplace.json — drop "always-on" framing in favor of language that
accurately describes conditional activation on note creation/editing.
…rt descriptions

Rewrites obsidian-vault/README.md to mirror trip-planner's proven shape:
promise-led lead paragraph, "What you get" bullets naming specific
failure modes (broken wikilinks, YAML type drift, callout fallbacks), a
dedicated "How it works" activation explainer, and a "Why a plugin?"
section that frames the alternative honestly (full conventions would
crowd out project-specific context in CLAUDE.md).

Short descriptions in plugin.json, marketplace.json, and the root
README plugins table now share the same line — "Let Claude edit your
Obsidian vault without breaking it. Wikilinks stay linked, frontmatter
stays queryable, callouts render — and Claude speaks Dataview, Tasks,
Templater, Bases, and Canvas fluently." — replacing the drier
"conventions applied automatically" framing.
@aliasunder aliasunder marked this pull request as ready for review April 21, 2026 16:52
@aliasunder aliasunder merged commit 932586e into main Apr 21, 2026
@aliasunder aliasunder deleted the feat/obsidian-vault-plugin branch April 21, 2026 16:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants