# Obsidian Ops

> Operations, syncing, versioning, and release management for Obsidian projects. Load when running builds, syncing references, bumping versions, or preparing for release.

- Skill: `davidvkimball/obsidian-ops` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add davidvkimball/obsidian-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/davidvkimball/obsidian-ops/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Coding & Dev Tools
- Author: davidvkimball (https://skillmd.com/u/davidvkimball)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/davidvkimball/obsidian-ops

---


# Obsidian Operations Skill

This skill covers the operational aspects of maintaining an Obsidian project, including build workflows, sync procedures, and release management.

## Purpose

To ensure reliable builds, consistent reference materials, and safe release processes while strictly following project policies.

## When to Use

Load this skill when:
- Running build or lint commands.
- Syncing reference documentation from external sources.
- Bumping project versions or preparing releases.
- Troubleshooting build or environment issues.

## Core Rules

- **NEVER perform automatic git operations**: AI agents must never execute `git commit`, `git push`, or any command that automatically stages or commits changes without explicit user approval for each step.
- **Verify Build**: Always run a build/lint after significant changes to ensure compatibility.
- **Sync Status**: Keep `sync-status.json` updated when updating reference materials.

## Bundled Resources

- `references/build-workflow.md`: Standard build and development commands.
- `references/release-readiness.md`: Checklist for ensuring a project is ready for release.
- `references/sync-procedure.md`: How to pull updates from reference repositories.
- `references/versioning-releases.md`: Workflow for versioning and GitHub releases.
- `references/troubleshooting.md`: Common issues and their resolutions.
- `references/quick-reference.md`: One-page cheat sheet for common operations.