issue-formatter

Validates frontmatter fields and required sections in legacy Obsidian issue records.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This deprecated skill helps standardize Issue Record notes by validating critical frontmatter fields and enforcing a consistent, actionable structure so issues are easier to triage and resolve.

Core Features & Use Cases

  • Frontmatter validation: Checks severity, issue_status, issue_category (when present), and validates issue_id against the expected ISS-YYYYMMDD-sequence format.
  • Missing structure completion: Ensures required section headings exist (e.g., problem description, environment, tried steps, root cause, solution, prevention) without removing existing content.
  • Vault linkage integrity checks: Marks missing referenced IDs in related_to / derived_from / solves with a warning for user confirmation rather than auto-editing outcomes.

Quick Start

Ask the AI to process an existing legacy issue note and format it according to the deprecated issue-formatter validation and section-structure rules.

Frequently Asked Questions about issue-formatter

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

FAQPage Schema
How do I validate frontmatter metadata in legacy Obsidian issue records?

You validate frontmatter in legacy Obsidian issue records by checking severity, issue_status, and issue_category enums while enforcing the ISS-YYYYMMDD-sequence pattern for issue_id. This ensures triage readiness without altering existing content.

What's the best way to check vault references and missing cross-links in issue notes?

Checking vault references detects missing referenced IDs in related_to, derived_from, and solves fields, marking them with warnings for user confirmation. It avoids auto-editing outcomes to maintain non-destructive behavior during issue triage.

How do I enforce a consistent section structure for issue tracking notes?

You enforce section structure by adding required analytical headings like problem description, environment, tried steps, root cause, solution, and prevention to issue tracking notes. This completes missing structures non-destructively without removing existing content.

Can I use issue-formatter for risk management and research governance workflows?

Yes, issue-formatter supports risk management and research governance workflows by standardizing deprecated Issue Record notes. It validates issue metadata, enforces actionable analytical structure, and ensures falsification workflow compliance for easier triage and resolution.

Does the issue formatting process modify or delete existing note content during validation?

No, the validation process exhibits non-destructive behavior and does not modify or delete existing note content. It only marks missing vault references with warnings and appends required section headings where absent.