--- name: obsidian-auto-classifier description: "Intelligently organize and categorize Markdown notes within an Obsidian vault. This skill leverages Obsidian MCP tools to analyze the vault's current folder structure and note content, ensuring new or misplaced notes are moved to their most contextually appropriate locations (e.g., PARA, Zettelkasten, or custom taxonomies)." --- # Obsidian Auto Classifier (MCP-Powered) This skill provides an intelligent workflow for maintaining a clean and organized Obsidian vault by leveraging Model Context Protocol (MCP) tools for real-time vault analysis. ## Categorization Workflow ### 1. Structure Discovery (via Obsidian MCP) The agent must use MCP tools to map the vault's existing organizational logic. - **Action**: Call `list_directory` starting from the root (`/`) to identify top-level folders (e.g., `00 Inbox`, `20 Areas`, `30 Zettelkasten`). - **Deep Scan**: For folders like `30 Zettelkasten` or `40 Resources`, call `list_directory` on subfolders to understand the nested hierarchy. - **Logic**: Identify if the vault follows PARA, Zettelkasten, Johnny.Decimal, or a custom system. ### 2. Note Analysis Before moving a note, the agent must understand its "intent" and "content". - **Action**: Call `read_note` for the target file in the inbox or source folder. - **Key Indicators**: - **Frontmatter**: Look for `tags`, `category`, `project`, or `alias`. - **Content Analysis**: Check for keywords, wiki-links to existing projects, or specific templates (e.g., Meeting Notes vs. Paper Summaries). - **Contextual Search**: Use `search_notes` with the note's primary topic to see where similar notes are currently stored. ### 3. Smart Classification Decisions Compare the note's profile against the discovered taxonomy: - **Daily/Periodic**: Move to `00 Daily Notes` or `Log` (often sorted by year/month). - **Slipbox/Zettel**: Move to `31 Literature` or `32 Permanent` based on depth and source citations. - **Projects/Areas**: Move based on active project names found in the text. - **Archive**: Move finalized research, completed project logs, or legacy notes to `50 Archive`. ### 4. MOC Synchronization After moving a note, the agent MUST update the relevant Map of Content (MOC) in `30 Zettelkasten/33 Maps of Content/`. - **Action**: Read the MOC file that corresponds to the note's domain (e.g., `MOC-Reinforcement Learning.md` for RL papers, `MOC-Robotics and Embodied AI.md` for robotics). - **Add Entry**: Insert the note as a wikilink with a brief one-line description under the appropriate section heading. - **Format**: `- [[Note Filename|Short Alias]]: One-sentence description of the note's contribution.` - **New Section**: If no existing section fits, create a new one following the MOC's heading convention. - **Cross-MOC**: If the note spans multiple domains, add it to all relevant MOCs. ### 5. Verified Execution - **Move**: Use `move_note` (via MCP) or `Move-Item` (via Shell) to relocate the note. - **Cleanup**: If the note was moved from a temporary folder (like `00 Inbox`), confirm the source is clean. - **MOC Update**: Ensure the corresponding Map of Content has been updated (see Section 4). - **Metadata Update**: (Optional) Call `update_frontmatter` to reflect the new category or update the `modified` timestamp. ## Example Obsidian Triggers - "整理一下我的 `00 Inbox`，把笔记归位。" (Organize my inbox and put notes back in their place.) - "把这个 Zettel 笔记放到我的 Slipbox/Literature 里。" (Move this Zettel note into my Slipbox/Literature.) - "识别这个笔记的内容，看看它属于哪个项目文件夹。" (Identify the content of this note and see which project folder it belongs to.) - "我刚写了一篇论文综述，把它存到合适的文献库位置。" (I just wrote a paper review, save it to the appropriate literature library location.) - "扫描我的 Daily Notes，把其中关于 'Robotics' 的内容提取或移动到资源库。" (Scan my Daily Notes and extract or move content about 'Robotics' to the Resources library.) ## Note for Agents - **MCP Priority**: Always use `list_directory` and `read_note` via the Obsidian MCP first to ensure you are working with the real-time state of the vault. - **No Hallucination**: Do not assume folder names (e.g., `Archives` vs `50 Archive`). Always verify path existence before moving. - **Link Integrity**: Be aware that moving notes might affect internal links. Obsidian usually handles this, but verify if the user's settings require manual link updates. --- Source attribution: JaimeParker Original project: https://github.com/JaimeParker/stable-jarvis/blob/cb2c7078e8b76a3125ae504aeb1ffa9c1ee2dc4b/skills/obsidian-auto-classifier/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Zhaohong Liu Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: JaimeParker Original project: https://github.com/JaimeParker/stable-jarvis/blob/cb2c7078e8b76a3125ae504aeb1ffa9c1ee2dc4b/skills/obsidian-auto-classifier/SKILL.md Attribution basis: Source repository record Fields of work: Design, Education & Research, Marketing Roles: Content Marketer, Researcher, UX Writer Specialties: Word Documents, Frontend Tools: Obsidian Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 9894781ad12fabc35092939bb7465112be5ab300fa33c290fba9d5298f258e6e