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.

Scope

This skill covers:

• Build and lint workflows
• Syncing reference documentation from external sources
• Version management and release preparation
• Build and environment troubleshooting

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/scorecard-compliance.md: Map of Obsidian community plugin scorecard signals to concrete fixes (vulnerability overrides, attestation workflow, CSS dedup, obsidianmd rules).
• references/contributing-template.md: Portable CONTRIBUTING.md template for the scorecard hygiene check.
• references/security-privacy.md: Developer policies, mandatory disclosures, and dependency vulnerability hygiene via pnpm.overrides.
• references/sync-procedure.md: How to pull updates from reference repositories.
• references/versioning-releases.md: Workflow for versioning and GitHub releases, including the build-provenance attestation pattern.
• references/troubleshooting.md: Common issues and their resolutions.
• references/quick-reference.md: One-page cheat sheet for common operations.