/polish
Improve existing notes in place — clearer structure, bullet-first, artifacts that teach, better links
> /plugin marketplace add Michael-OvO/obsidian-knowledge-agent > /plugin install obsidian-knowledge@obsidian-knowledge-agent
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/polish
Context preview
What this command does when you run it.
Improve existing notes in place — clearer structure, bullet-first, artifacts that teach, better links
Command definition
polish.mddescription: Improve existing notes in place — clearer structure, bullet-first, artifacts that teach, better links argument-hint: [a note or folder to polish; default: recently changed notes]
Run the teaching-quality pass on the target (`$ARGUMENTS`, or the most recently changed notes if none is given). Read `.agents/style-guide.md` first.
1. **Select** the note(s). For a folder, polish the content and concept notes (skip indexes and source notes unless I ask). 2. **Review against the style guide:** does the body read naturally top to bottom? Is the machinery off-stage (metadata in frontmatter, no rubric headings)? For technical notes, is it bullet-first with the artifacts that genuinely teach (runnable code, an equation, a diagram)? Are related links specific and useful? 3. **Rewrite only the failing parts** — never restate a whole note and never change its meaning. Add a missing artifact only where it actually helps. 4. **Fix and wire wikilinks**, then validate them (the bundled `scripts/validate_links.py`, or the inline check in the workflow). Show me the diffs before committing.
Talk to your vault. It does the rest. You drop it in. It files, it teaches, and it remembers how you like your notes. Point any agentic assistant at your Obsidian vault and talk to it — "save this link", "organize my inbox", "ingest the syllabus in Inbox".
Repo: Michael-OvO/obsidian-knowledge-agent
Other commands on obsidian-knowledge-agent.
- /capture
Quickly save something as a single clean note in the right place — a link, a thought, an article, a snippet
Open command - /clean
Tidy and sync — commit changed notes, clear processed Inbox (with approval), and push
Open command - /doctor
Check vault health — broken links, orphans, missing frontmatter, MISSING placeholders — and propose fixes
Open command - /evolve
Review and approve the agent's proposed updates to its own learned rules
Open command - /help
Show everything the Obsidian Knowledge Agent can do, with every command and an example
Open command - /ingest
Turn material into notes at the right altitude — a quick capture, a small collection, or a full build
Open command