obsidian-note-optimizer

Optimize and diagnose Obsidian SP-STM research notes with type-specific structure constraints.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/xingchen2202/obsidian-ai-knowledge-system --skill obsidian-note-optimizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-note-optimizer
Source: https://github.com/xingchen2202/obsidian-ai-knowledge-system/tree/main/skills/obsidian-note-optimizer
Command: npx skills add https://github.com/xingchen2202/obsidian-ai-knowledge-system --skill obsidian-note-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you keep all SP-STM Obsidian notes consistent and high-quality by automatically optimizing structure, diagnosing compliance gaps, creating new typed notes, upgrading versions, and synthesizing insights across notes.

Core Features & Use Cases

  • Five optimization modes: OPTIMIZE, DIAGNOSE, CREATE, UPGRADE, SYNTHESIZE to cover day-to-day note lifecycle tasks.
  • Type-aware routing: dispatches the selected note type to the corresponding formatter (e.g., Research Log, Literature Note) while enforcing safety rules like no silent deletions.
  • Cross-note synthesis: generates statistics, contradiction reports, extracted paper-ready materials, or timelines from multiple notes.

Quick Start

Ask: “请把我这篇笔记做 OPTIMIZE(或 DIAGNOSE / CREATE / UPGRADE / SYNTHESIZE),并按你要求的规则补全缺失模块。”

Frequently Asked Questions about obsidian-note-optimizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce frontmatter compliance and structure consistency in Obsidian research notes?

To enforce frontmatter compliance in Obsidian research notes, use a mode-based optimization process that dispatches selected note types to corresponding formatters while applying safety constraints to prevent silent data deletion.

How does cross-note synthesis work for extracting insights from multiple Obsidian notes?

Cross-note synthesis for Obsidian notes works by processing multiple files to generate statistics, contradiction reports, extracted paper-ready materials, or timelines based on the aggregated content and enforced structure.

Can I create new typed Obsidian notes directly from user intent?

Yes, you can create new typed Obsidian notes from user intent by triggering a CREATE operation, which requires user confirmation for broad triggers to ensure the generated note matches the intended type-specific structure.

What is the best way to diagnose compliance gaps in an existing Obsidian research log?

The best way to diagnose compliance gaps in an Obsidian research log is to route the note through a fixed DIAGNOSE operation that evaluates type-specific structure and outputs a formatted compliance report.

What safety guardrails apply when upgrading Obsidian note versions?

Safety guardrails when upgrading Obsidian note versions strictly avoid deleting or fabricating data, ensuring the upgrade process preserves existing content while applying the required structural optimizations.

Do I need a specific note type to optimize my Obsidian literature notes?

Yes, optimizing Obsidian literature notes requires type-aware routing to dispatch the note to its corresponding formatter, ensuring the optimization process applies the correct structural and safety constraints.