make-confluence

Convert Markdown documentation into Confluence-formatted guides with Problem/Solution/Results structures.

Updated May 31, 2025

Search Tags:#automation #documentation #markdown #confluence #content-management #knowledge-sharing #confluence-guides

Ready to run

npx skills add https://github.com/dEitY719/dotfiles --skill make-confluence

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: make-confluence
Source: https://github.com/dEitY719/dotfiles/tree/main/claude/skills/make-confluence
Command: npx skills add https://github.com/dEitY719/dotfiles --skill make-confluence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform Markdown technical documentation into Confluence-formatted guides, consolidating structure for quick publishing and knowledge sharing.

Core Features & Use Cases

Content detection: automatically identifies Problem, Root Cause, Solution, and Results sections in Markdown.
TL;DR and difficulty estimation: generates a three-line executive summary and a star rating.
Output formatting and saving: converts to Confluence markdown and saves to rca-knowledge/docs/confluence-guides/{category}/YYYY-MM-DD-{title}.md.
Batch processing and category overrides: supports processing a whole directory and applying a specific category when needed.

Quick Start

Invoke the make_confluence tool on a Markdown file or directory to generate a Confluence-ready guide.

Frequently Asked Questions about make-confluence

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

FAQPage Schema

How do I convert Markdown documentation into Confluence-formatted guides?▼

The Skill converts Markdown documentation into Confluence-formatted guides by automatically extracting Problem, Root Cause, Solution, and Results structures, then generating a TL;DR and difficulty rating before saving the formatted output.

Can I batch process a whole directory of Markdown files for Confluence?▼

Yes, you can batch process a directory of Markdown files for Confluence by invoking the tool on the folder path, which parses each document, generates TL;DR summaries and difficulty ratings, and saves them to categorized output directories.

Does the Confluence guide generator automatically create summaries and difficulty ratings?▼

Yes, the Confluence guide generator automatically creates a three-line TL;DR executive summary and estimates a star-rating difficulty level based on the parsed Problem, Root Cause, Solution, and Results structures in the Markdown content.

How are converted Confluence guides organized and saved?▼

Converted Confluence guides are saved to the structured path rca-knowledge/docs/confluence-guides/{category}/YYYY-MM-DD-{title}.md, organizing files by category and date for efficient knowledge sharing.

Can I override the category when converting Markdown to Confluence format?▼

Yes, you can apply category overrides when converting Markdown to Confluence format, ensuring the output saves to your desired specific category directory rather than the auto-detected one.

What Markdown structures are required to generate a Confluence guide?▼

To generate a Confluence guide, the Markdown documentation should contain Problem, Root Cause, Solution, and Results sections, which the tool parses to structure the output and generate the TL;DR and difficulty rating.