obsidian-editor
Personal copy editor and content enhancer for Obsidian vault notes. Use when the user requests editing, enhancement, copyediting, critique, or improvement of markdown files. Typical triggers include "edit this file", "clean up these notes", "enhance this draft", "give me feedback on", "polish this content", "expand my shorthand", or "add links to this". Handles diverse content types including technical documentation, research notes, essays, Substack posts, administrative notes, and personal writing. Always preserves original content and appends enhanced version below a separator line.
When & Why to Use This Skill
The Obsidian Editor skill is an AI-powered personal copy editor and content enhancer specifically designed for Obsidian vault users. It streamlines the writing process by providing professional-grade editing, grammar correction, shorthand expansion, and structural critique. By strictly adhering to a content preservation rule—appending improvements below a separator—it ensures users never lose their original thoughts while benefiting from high-quality prose refinement and stylistic adaptation.
Use Cases
- Technical Documentation Polishing: Refine complex technical notes or research findings into clear, structured, and professional documentation while maintaining technical accuracy.
- Shorthand Expansion: Convert fragmented meeting notes, quick brainstorms, or abbreviated fragments into cohesive, readable prose automatically.
- Creative Content Critique: Get structured feedback and stylistic enhancements for Substack drafts, essays, or blog posts to improve reader engagement and flow.
- Knowledge Base Optimization: Enhance existing markdown notes by adding relevant links, citations, and improving internal organization for better long-term knowledge management.
| name | obsidian-editor |
|---|---|
| description | Personal copy editor and content enhancer for Obsidian vault notes. Use when the user requests editing, enhancement, copyediting, critique, or improvement of markdown files. Typical triggers include "edit this file", "clean up these notes", "enhance this draft", "give me feedback on", "polish this content", "expand my shorthand", or "add links to this". Handles diverse content types including technical documentation, research notes, essays, Substack posts, administrative notes, and personal writing. Always preserves original content and appends enhanced version below a separator line. |
Obsidian Editor
Personal copy editor and enhancement partner for all Obsidian vault content.
Core Principles
CRITICAL - Content Preservation Rule: NEVER modify or delete original content. Always preserve the original content exactly as-is above a horizontal line separator (---), then append the enhanced version below.
File Handling: Always edit the same file the user references. Never create new files or rename files unless explicitly requested.
Mode Detection: Auto-detect the appropriate editing mode(s) from context clues in the user's request and the content itself. If the user explicitly specifies a mode or approach, that takes absolute precedence.
Style Adaptation: Infer the appropriate style and formality from the content type:
- Technical/work content → formal, precise, structured
- Essays/Substack posts → conversational but polished, engaging
- Administrative/personal notes → clear, brief, action-oriented
Workflow
Read the specified file from the user's Obsidian vault
Detect editing mode(s) from context:
- Copyedit: Fix grammar, spelling, clarity, flow
- Shorthand expansion: Convert abbreviations and fragments to prose
- Link enhancement: Add relevant URLs and citations
- Critique: Provide structured feedback and suggestions
- Mixed modes are common
Apply the golden rule: Preserve original content above
---, append enhanced version belowEdit the file using str_replace:
- Keep original content intact
- Add
---separator - Append enhanced version with appropriate mode(s) applied
- Match the detected style/formality to the content type
Confirm completion briefly without excessive explanation
Mode Selection Examples
User says: "Clean up the grammar in project-notes.md" → Auto-detect: Copyedit mode
User says: "Expand my shorthand notes from the meeting" → Auto-detect: Shorthand expansion mode
User says: "Give me feedback on my Substack draft" → Auto-detect: Critique mode (essay style)
User says: "Polish this technical doc and add relevant links" → Auto-detect: Copyedit + link enhancement modes (formal style)
User says: "Make this better" (viewing technical content) → Auto-detect: Copyedit + possibly shorthand expansion (formal style)
When to Load References
Load references/editing-modes.md when:
- You need detailed examples of how to apply a specific mode
- The editing request is ambiguous and examples would help
- You want to see the expected output format for critique mode
- You're combining multiple modes and need guidance on integration
Example Structure
Before editing:
# My Notes
Some content here with typos and shorthand...
After editing:
# My Notes
Some content here with typos and shorthand...
---
# My Notes
Enhanced content with corrections and improvements...
Domain Flexibility
This skill works across all content types:
- Work documentation (FactSet knowledge graphs, AI/ML workflows)
- Research notes (academic papers, NeuroSymbolic AI, technical findings)
- Essays and blog posts (Substack articles, personal writing)
- Teaching materials (course content, lesson plans)
- Homelab and technical projects (infrastructure, coding notes)
- Administrative content (appointments, task lists, planning)
Adapt your editing approach to match each domain's conventions and requirements.