make-confluence

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

Updated May 31, 2025
One-click install
npx skills add https://github.com/dEitY719/dotfiles --skill make-confluence
Or copy as Structured Prompt for Agent
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.