literature-formatter

Validate Obsidian literature notes for required frontmatter and citation safety.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps you convert inconsistent literature-note entries into a complete, citation-safe, SP-STM-compatible record by validating required metadata and relationships without fabricating any information.

Core Features & Use Cases

  • Required-field completeness checks: Verifies the presence of doi, zotero_key, journal, year, authors, and reproducibility_status, and flags missing fields for user completion.
  • Reproducibility status validation: Ensures reproducibility_status is one of 未验证 / 部分验证 / 已验证 / 不适用 and guides corrections in the SP-STM context.
  • Structure and citation hygiene enforcement: Recommends missing section headings, checks for suspicious/unverifiable citations, validates lit_id format (LIT-YYYY-FirstAuthor-Keyword), and flags dangling vault references (related_to/derived_from/solves) without auto-filling solves.
  • Safety constraints for research integrity: Prevents citation fabrication, avoids altering original experimental data, and enforces consistent formula formatting and professional terminology labeling.

Quick Start

Ask the AI to format an existing Obsidian literature note by validating all required frontmatter fields, checking lit_id and citation integrity, and marking any missing sections or suspended vault references for review.

Frequently Asked Questions about literature-formatter

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

FAQPage Schema
How do I validate Obsidian literature notes for required frontmatter fields?

To validate Obsidian literature notes, the formatter checks required frontmatter fields including doi, zotero_key, journal, year, authors, and reproducibility_status, flagging any missing entries for user completion without fabricating data.

What is the correct reproducibility_status format for SP-STM literature notes?

The correct reproducibility_status format for SP-STM literature notes must be one of four allowed values: 未验证, 部分验证, 已验证, or 不适用. The validator ensures your entry matches one of these exact statuses.

How do I check citation integrity and flag unresolved vault ID links in Obsidian?

To check citation integrity in Obsidian, the formatter validates lit_id formatting and GB/T 7714-compatible references while flagging dangling vault references in related_to, derived_from, and solves fields without auto-filling missing links.

Does literature note formatting enforce safety constraints against citation fabrication?

Yes, literature note formatting enforces research integrity by preventing citation fabrication, avoiding alterations to original experimental data, and enforcing consistent formula formatting and professional terminology labeling for SP-STM compatibility.

Can I automatically generate missing section headings for SP-STM-compatible records?

You cannot fully automate record generation, but the formatter recommends missing section headings and provides user-directed prompts for uncertain fields, ensuring you manually review and complete all missing or suspicious citations.