discourse-graph

Guide users in building discourse graphs within Obsidian vaults.

4|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/flowing-abyss/obsidian-vault-skills --skill discourse-graph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discourse-graph
Source: https://github.com/flowing-abyss/obsidian-vault-skills/tree/main/skills/discourse-graph
Command: npx skills add https://github.com/flowing-abyss/obsidian-vault-skills --skill discourse-graph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a guided approach to constructing structured discourse graphs in Obsidian vaults, helping users organize questions, claims, evidence, and synthesis without auto-generating content.

Core Features & Use Cases

  • Node type guidance: maps notes to the appropriate discourse node type (question, context, observation, claim, evidence, synthesis).
  • Hierarchy validation: checks parent-child relationships and flags gaps like claims without evidence.
  • Vault discovery: scans base/notes and related references to surface relevant material for graph construction.
  • Non-destructive workflow: never creates content; only guides structure and asks for explicit user confirmation when creating nodes.

Quick Start

Map my research question into a discourse graph hierarchy and identify initial node types.

Frequently Asked Questions about discourse-graph

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

FAQPage Schema
How do I structure argument graphs in Obsidian for a literature review?

Discourse graphs organize literature reviews by mapping Obsidian notes into structured node types like questions, claims, evidence, and synthesis, validating parent-child relationships to identify structural gaps.

What is the best way to validate hierarchy and missing evidence in Obsidian notes?

Validating hierarchy in Obsidian notes involves scanning your vault to check parent-child relationships, flagging gaps like claims without supporting evidence, and guiding appropriate node placements.

Can I automatically generate discourse graph content from my vault notes?

No, this approach enforces non-generation of content. It only scans vault notes to suggest appropriate discourse node placements and structure, requiring explicit user requests to create or modify nodes.

How do I map my research questions into a discourse graph hierarchy?

Mapping research questions involves scanning base notes and references to surface relevant material, suggesting appropriate node types, and outlining the hierarchy for structured argument planning.

Does this discourse graph approach work for structured argument planning outside literature reviews?

Yes, discourse graph hierarchy validation applies to any structured argument planning. It guides node type mapping and checks parent-child relationships across general Obsidian vault notes.