diff --git a/.agent/skills/obsidian-plugin/SKILL.md b/.agent/skills/obsidian-plugin/SKILL.md
new file mode 100644
index 0000000..5478088
--- /dev/null
+++ b/.agent/skills/obsidian-plugin/SKILL.md
@@ -0,0 +1,41 @@
+---
+name: managing-obsidian-plugin
+description: Manages the development, refactoring, and maintenance of an Obsidian plugin coding project. Use when the user requests feature additions, bug fixes, UI improvements, or refactoring in the Obsidian plugin codebase.
+---
+
+# Managing Obsidian Plugin
+
+## When to use this skill
+- Adding new features or settings to the Obsidian plugin.
+- Refactoring existing plugin components (e.g., UI, logic).
+- Fixing bugs or testing plugin functionality.
+- Managing Obsidian API interactions.
+
+## Workflow
+
+### 1. Plan & Analyze
+- [ ] Read relevant workspace files to locate the affected components (e.g., `main.ts`, view files, or service classes).
+- [ ] Check `manifest.json` for required plugin version bumps if deploying a new release.
+- [ ] Identify dependencies between UI components, styles, and core logic.
+
+### 2. Validate
+- [ ] Validate changes against existing test suites using relevant testing scripts.
+- [ ] Check if the changes necessitate an update to settings menus or serialized data structures.
+
+### 3. Execute
+- [ ] Apply code changes using progressive and isolated module updates.
+- [ ] Run `npm run build` to verify compilation without errors.
+
+## Instructions
+- Keep interactions with the Obsidian API well-isolated and properly typed.
+- Prioritize updating or creating unit tests alongside feature development to verify logic safely.
+- If a build script fails, do not proceed blindly; troubleshoot the specific error output before continuing.
+
+## Architecture
+- We use a vertical slice architecture.
+- Strict adherance to cleancode rules.
+- Use the provided .agent/skills/obsidian-plugin/SKILL.md as the main source of truth for coding standards and best practices.
+- Use ADRs to document design decisions in adr/. Refer to the ADRs folder for more information and ensure compliance with existing ADRs.
+
+## Resources
+- None