obsidian-doc-workflow

Create, classify, and archive Obsidian vault documents following structured templates and conventions.

7|Updated Sep 19, 2026
One-click install
npx skills add https://github.com/ehsanghaffar/skills --skill obsidian-doc-workflow-ehsanghaffar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-doc-workflow
Source: https://github.com/ehsanghaffar/skills/tree/main/skills/obsidian-doc-workflow
Command: npx skills add https://github.com/ehsanghaffar/skills --skill obsidian-doc-workflow-ehsanghaffar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Maintaining a consistent, well-organized Obsidian knowledge base becomes difficult as documentation grows across multiple projects. This Skill enforces a formal documentation system with strict conventions for document types, frontmatter, tagging, linking, and archival so every note lands in the right place with the right structure. ## Core Features & Use Cases - Structured Document Creation: Generates project documents and shared knowledge notes from canonical templates with complete YAML frontmatter (type, status, area, dates, tags). - Classification & Organization: Routes content to Projects, Shared Knowledge, Resources, or Archives using explicit decision rules and flowcharts. - Archival Workflow: Moves obsolete content to Deprecated, Superseded, or Historical folders with status updates and forward links, never deleting content outright. - Use Case: After finishing a project architecture review, ask the agent to create an ADR in the project's Decisions folder, link it from the architecture document, and archive the superseded design doc with proper status and backlinks. ## Quick Start Create a new Architecture document for my project in the Obsidian vault using the standard template and link it from the Project Overview.

Frequently Asked Questions about obsidian-doc-workflow

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

FAQPage Schema
How do I create a new project document in an Obsidian vault?▼

Determine the document type and location, copy the matching template from 00 Meta/Templates, fill all required frontmatter with the current date, write content following the template structure, link related documents, and place the file in the correct project folder.

How do I decide between project docs and shared knowledge in Obsidian?▼

Place content in 01 Projects if it references project-specific code, configuration, or workflows that become obsolete when the project ends. Place reusable patterns, technology guides, and tool documentation in 02 Shared Knowledge where they remain useful across projects.

What frontmatter fields are required for Obsidian documentation?▼

All documents require type, status, created, and updated dates. Project documents additionally require project and area fields, while resource documents require a source field. Property order follows type, status, project, area, created, updated, tags.

How should I archive outdated Obsidian notes without losing history?▼

Move the file to 04 Archives under Deprecated, Superseded, or Historical, update the status frontmatter field, and add a link from the replacement document to the archived version. Never delete content directly; always archive first.

What are the tagging rules for an Obsidian documentation vault?▼

Tags must be lowercase kebab-case with a maximum of five per document. Every document needs at least one domain tag like architecture or testing and one document type tag like guide or adr, with technology and project tags added sparingly.

When should ADRs not be moved to the archive folder?▼

Accepted, superseded, and rejected ADRs always remain in the project's Decisions folder. Superseded ADRs keep their location with status set to superseded, and new ADRs link back to them for continuity.