Agent skill
obsidian-structure
Enforce PARA structure and tags in Obsidian vault properly
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/obsidian-structure
SKILL.md
Skill: obsidian-structure
What I do
I provide expertise in architecting and maintaining an Obsidian vault using the PARA method (Projects, Areas, Resources, Archive). I specialise in defining folder hierarchies, tagging conventions, and linking patterns that ensure the vault remains navigable, scalable, and organised as it grows.
When to use me
- When setting up a new vault or reorganising an existing one.
- When deciding whether to use a folder, a tag, or a link for a new piece of information.
- When creating a Map of Content (MOC) to provide a high-level entry point to a topic.
- When archiving completed projects to keep the active workspace clean and focused.
Core principles
- Actionability-Based Sorting (PARA) — Organise notes by their level of actionability: Projects (active), Areas (ongoing responsibilities), Resources (topics of interest), and Archive (completed or inactive).
- The MOC Pattern — Use "Maps of Content" as non-linear indices to group related notes without relying solely on rigid folder structures.
- Flat over Deep — Prefer shallower folder structures combined with robust linking and tagging to avoid losing notes in deep sub-folder hierarchies.
- Naming Consistency — Use `Title Case` for note names and `kebab-case` for tags to maintain a professional and scannable interface.
Patterns & examples
PARA Folder Hierarchy
A standard top-level structure for the vault.
- `1. Projects/` — Active tasks with a deadline.
- `2. Areas/` — Ongoing responsibilities (e.g. Finances, Health).
- `3. Resources/` — Knowledge base, interests, and references.
- `4. Archive/` — Completed projects and inactive areas.
- `Templates/` — Reusable note structures.
The Index Note (MOC)
A central hub for a specific resource area.
# Obsidian Knowledge Base MOC
Index of all notes related to vault management.
## Core Components
- [[Obsidian Structure]]: PARA and organisation.
- [[Obsidian Frontmatter]]: Metadata standards.
## Advanced Scripting
- [[Obsidian Dataview Expert]]: Dynamic indexing.
- [[Obsidian CustomJS Expert]]: Reusable logic.
Tagging Conventions
Hierarchical tags for multi-dimensional organisation.
- `#status/in-progress`
- `#topic/git/workflow`
- `#type/permanent-note`
Anti-patterns to avoid
- ❌ Folder Overload — Creating a new folder for every minor sub-topic instead of using links or tags.
- ❌ Tag Explosion — Creating hundreds of unique tags that are only used once; this makes the tag cloud useless for filtering.
- ❌ The Junk Drawer Folder — Letting a "Misc" or "Inbox" folder grow indefinitely without regular processing and filing.
- ❌ Ignoring the Archive — Leaving finished projects in the active `Projects` folder, which creates visual clutter and mental load.
KB Reference
~/vaults/baphled/3. Resources/Knowledge Base/AI Development System/Skills/Session-Knowledge/Obsidian Structure.md
Related skills
obsidian-frontmatter— For defining the metadata that supports structural organisation.information-architecture— For the underlying theory of knowledge organisation.obsidian-consolidation— For refining and merging notes as the vault structure evolves.note-taking— For capturing the atomic content that populates the PARA structure.knowledge-base— For querying the structural health of the vault.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?