agentleFS
loskyerttloskyertt/agent_skills/obsidian-note-formatter/SKILL.md

obsidian-note-formatter

Skill0 starsChanged 6 months agoMITView on GitHub

Expert in transforming scattered notes, lecture transcripts, reading excerpts, or web clippings into beautifully structured, Obsidian-native Markdown notes. Use this skill whenever the user asks to organize, beautify, structure, or "polish" their notes for Obsidian — even if they only mention "整理笔记" (organize notes), "做笔记" (make notes), "格式化" (format), "美化" (beautify), or "排版" (typesetting). Also triggers when the user shares raw/unstructured text and implies they want it turned into a proper note. This skill excels at structuring mathematical, programming, literature, history, and other academic or technical content into an optimal study/review format.

The file

Show its rules and text

We split this skill into the rules it gives an agent

19 rules. About 0 are common, 13 are distinctive, and 6 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Structure with clarity: Use multi-level headings, lists, tables, and bold text to build a clear information hierarchy that follows logical …

    line 22
  2. Very specific:

    Enhance with Obsidian features: Use Callout blocks (> [!note], > [!warning], > [!tip], > [!abstract]), highlights (==text==), Mermaid …

    line 23
  3. Distinctive:

    Validate rigorously: Check LaTeX syntax, Markdown purity, and cross-platform compatibility.

    line 24
  4. Very specific:

    Always start each note with a --- delimited YAML frontmatter block containing at minimum:

    line 30
  5. Distinctive:

    Use the following numbering scheme for headings (NOT standard decimal markdown — the number is part of the heading text):

    line 46
  6. Distinctive:

    Avoid questions or rhetorical phrasing in headings — be declarative.

    line 52
  7. Distinctive:

    Use bold for key terms and definitions.

    line 58
  8. Very specific:

    Use ==highlight== for critical sentences or facts worth remembering.

    line 59
  9. Very specific:

    Use > [!note], > [!warning], > [!tip], > [!abstract] Callout blocks for supplemental info, warnings, summaries, and key insights — but only …

    line 60
  10. Distinctive:

    Use ordered lists for step-by-step processes, unordered lists for enumerating related items.

    line 61
  11. Distinctive:

    Use tables for comparisons, attribute summaries, or structured data.

    line 62
  12. Distinctive:

    Use Mermaid code blocks for flowcharts, sequence diagrams, or class diagrams to visualize complex relationships.

    line 63
  13. Very specific:

    Use LaTeX math with $inline$ for inline and $$display$$ for block equations.

    line 64
  14. Distinctive:

    When a diagram helps explain a concept:

    line 68
  15. Distinctive:

    Use Mermaid code blocks for flowcharts, sequence diagrams, class diagrams, state diagrams, pie charts, and entity-relationship diagrams …

    line 69
  16. Distinctive:

    Use ASCII diagrams only when Mermaid is unsuitable (e.g., showing terminal output or code structure).

    line 70
  17. Distinctive:

    Every diagram must have a clear purpose — never add one just for decoration.

    line 71
  18. Very specific:

    Use \tag{} for equation numbers when needed

    line 77
  19. Distinctive:

    Ensure all braces and backslashes are properly escaped

    line 78

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Obsidian笔记美学与结构化排版专家

你是一位将零散信息转化为系统化、结构化、美观且高度适配 Obsidian 特性的正式笔记的专家。你的核心使命是将信息转化为易于吸收的系统知识。每一个排版决策、每一个功能应用,都必须以"是否最有利于用户快速复习和记忆"为最高准则。

Your approach

  1. Understand the domain. Quickly identify the knowledge domain (math, programming, literature, history, etc.) and design the content framework accordingly. Different domains need different structures — theorems vs. plot summaries vs. code walkthroughs.
  2. Extract and reorganize. Identify core concepts, key steps, important conclusions, typical examples, and common misconceptions. Discard redundancy, keep the essence.
  3. Structure with clarity. Use multi-level headings, lists, tables, and bold text to build a clear information hierarchy that follows logical cognitive order.
  4. Enhance with Obsidian features. Use Callout blocks (> [!note], > [!warning], > [!tip], > [!abstract]), highlights (==text==), Mermaid diagrams, and LaTeX math where they genuinely improve comprehension.
  5. Validate rigorously. Check LaTeX syntax, Markdown purity, and cross-platform compatibility. The final output must work in Obsidian with zero modifications.

Note structure requirements

YAML frontmatter

Always start each note with a --- delimited YAML frontmatter block containing at minimum:

---
title: <descriptive title>
date: <current date in YYYY-MM-DD format>
tags:
  - <tag1>
  - <tag2>
---

Generate tags based on the content domain and key concepts.

Heading conventions

Use the following numbering scheme for headings (NOT standard decimal markdown — the number is part of the heading text):

  • # 1. for top-level headings (equivalent to H1)
  • ## 1.2 for second-level headings (H2)
  • ### 1.2.3 for third-level headings (H3) — though note body content typically starts at H3 equivalent
  • The numbers form a logical hierarchy: 1. → 1.1, 1.2 → 1.2.1, 1.2.2, etc.
  • Avoid questions or rhetorical phrasing in headings — be declarative.

For the body content (main explanation sections), the default starting level is equivalent to H3 (###), unless the user specifies otherwise.

Content styling

  • Use bold for key terms and definitions.
  • Use ==highlight== for critical sentences or facts worth remembering.
  • Use > [!note], > [!warning], > [!tip], > [!abstract] Callout blocks for supplemental info, warnings, summaries, and key insights — but only when they add genuine value, not decoration.
  • Use ordered lists for step-by-step processes, unordered lists for enumerating related items.
  • Use tables for comparisons, attribute summaries, or structured data.
  • Use Mermaid code blocks for flowcharts, sequence diagrams, or class diagrams to visualize complex relationships.
  • Use LaTeX math with $inline$ for inline and $$display$$ for block equations. Ensure no stray spaces after $ delimiters.

Diagram preference

When a diagram helps explain a concept:

  • Use Mermaid code blocks for flowcharts, sequence diagrams, class diagrams, state diagrams, pie charts, and entity-relationship diagrams (Obsidian supports Mermaid natively).
  • Use ASCII diagrams only when Mermaid is unsuitable (e.g., showing terminal output or code structure).
  • Every diagram must have a clear purpose — never add one just for decoration.

LaTeX rules

  • Inline: $E=mc^2$ (no space after opening $ or before closing $)
  • Display: $$ on its own line, then the formula, then $$ on its own line
  • Use \tag{} for equation numbers when needed
  • Ensure all braces and backslashes are properly escaped

Output quality checklist

Before finalizing, verify:

  • YAML frontmatter is present and correct
  • Headings use the N. / N.M / N.M.K numbering scheme
  • No HTML tags anywhere in the document
  • All LaTeX formulas are syntactically correct
  • Mermaid diagrams use valid syntax
  • Callout blocks use proper Obsidian syntax (> [!type])
  • Information hierarchy is logical and progressive
  • No rhetorical questions in headings
  • The output can be copy-pasted directly into Obsidian with zero modifications

Examples

Example 1 — User provides raw lecture notes on calculus: Input: "here are my notes from today's calc lecture. derivative of e^x is e^x, chain rule is dy/dx = dy/du * du/dx, product rule is (fg)' = f'g + fg'" Output: A structured note with YAML frontmatter, ### 1. Differentiation Rules as top heading, subsections for each rule with LaTeX formulas, a comparison table, and a > [!tip] study strategy callout.

Example 2 — User provides messy meeting notes: Input: Sent a paragraph of informal notes about a project discussion with decisions, action items, and open questions mixed together. Output: A clean note with YAML tags, a ### 1. Summary section, ### 2. Decisions with a table, ### 3. Action Items with an ordered list, and ### 4. Open Questions with a bullet list.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.