promote-thinking

Convert resolved thinking sessions into formal research documents with backlinks.

14|4|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/GregTheGreek/claude-obsidian --skill promote-thinking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: promote-thinking
Source: https://github.com/GregTheGreek/claude-obsidian/tree/main/skills/promote-thinking
Command: npx skills add https://github.com/GregTheGreek/claude-obsidian --skill promote-thinking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool helps researchers convert informal thinking notes into formal, citable research documents, ensuring consistent structure and traceability.

Core Features & Use Cases

  • Automated Promotion: Converts a thinking session into a formatted research draft with a structured summary, key findings, conclusions, and open questions.
  • Backlink & Provenance: Updates backlinks between the thinking session and the new research document for traceability.
  • Workflow Integration: Guides the selection of a Research subdirectory, enforces naming rules, and records provenance in frontmatter.

Quick Start

Promote a recent thinking session to a formal research draft by invoking the promote-thinking command with an optional session path.

Frequently Asked Questions about promote-thinking

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

FAQPage Schema
How do I convert informal thinking notes into formal research documents in Obsidian?

To convert thinking notes into formal research documents, you promote resolved thinking sessions into structured drafts. This process maps core questions to summaries, captures insights, and maintains provenance through back-links within your knowledge management workflow.

What is the best way to document resolved thinking sessions for long-term knowledge management?

Documenting resolved thinking sessions involves transforming them into formatted research drafts with structured summaries, key findings, conclusions, and open questions. This ensures durable documentation and consistent structure for long-term knowledge management.

Can I maintain backlinks and provenance when promoting thinking sessions to research drafts?

Yes, promoting thinking sessions to research drafts automatically updates backlinks between the original session and the new document. This maintains provenance by recording source links and metadata in the document frontmatter for full traceability.

How do I organize promoted research documents within Obsidian workflows?

Organizing promoted research documents is handled by guiding the selection of a Research subdirectory and enforcing naming rules during the promotion process. This keeps your Obsidian workflows structured and ensures consistent document storage.

When should I formalize thinking notes into citable research documents?

You should formalize thinking notes when a thinking session has reached conclusions and requires durable documentation. Promoting these sessions ensures that resolved insights are captured as citable research documents rather than remaining as informal notes.

Does promoting thinking sessions to research docs require specific folder structures?

Promoting thinking sessions requires selecting a Research subdirectory for the output document. The workflow enforces naming rules and records provenance in frontmatter, ensuring the formalized research draft integrates correctly into your existing documentation structure.