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.