Skip to main content
skill CX Codex

confluence-deep-reader — Claude Code skill: guide

confluence-deep-reader is a Claude Code skill that traverses Confluence page trees to depth 3 and synthesizes hierarchical documentation.

Apache-2.0 1 installs ★ 939 updated 2026-05-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add krafton-ai/KIRA --skill confluence-deep-reader -a claude-code
Open on GitHub

What confluence-deep-reader does

This skill guides the agent across nested Confluence articles. It begins by opening the entry page with getConfluencePage, then discovers nested descendants via getConfluencePageDescendants. The workflow continues step-by-step through direct children, grandchildren, and great-grandchildren.

The system sets a hard stop at depth 3. Whenever a documentation tree contains over 20 items, the agent asks whether to parse everything or concentrate on selected branches. Missing or restricted pages get marked in notes without interrupting the overall run.

Operational success depends on functional getConfluencePage and getConfluencePageDescendants tools in your agent setup. Without configured Confluence access, page fetching cannot proceed.

What it helps with

  • crawl an entire Confluence section from a single page URL
  • inspect parent and descendant documentation down to depth 3
  • summarize multi-tier documentation trees while preserving hierarchy
  • catch inaccessible Confluence pages during branch scans

Example prompts for the agent

  • Read this Confluence page and all its subpages: <link>
  • Analyze this Confluence documentation tree down to child levels and summarize it
  • Review the parent page and descendants at <link>, then structure the findings

How to install confluence-deep-reader

1Skills CLI (Vercel)

npx skills add krafton-ai/KIRA --skill confluence-deep-reader -a claude-code

2Manually: put the files in place

~/.claude/skills/confluence-deep-reader/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/confluence-deep-reader/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about confluence-deep-reader

How to install confluence-deep-reader in Claude Code?

Run npx skills add krafton-ai/KIRA --skill confluence-deep-reader -a claude-code. The file will be placed in ~/.claude/skills/confluence-deep-reader/SKILL.md.

What does confluence-deep-reader do?

It instructs the agent to read an initial Confluence document and systematically retrieve descendant pages up to 3 levels deep before drafting a final summary.

Can the skill traverse beyond depth 3?

No, traversal strictly stops at depth 3. The agent notes any deeper unread branches so you can target specific subtrees manually.

Source text

SKILL.md · Apache-2.0
---
name: confluence-deep-reader
description: Read a Confluence page and recursively explore its child pages up to 3 levels deep. Use when users want to comprehensively read a Confluence page tree, understand hierarchical documentation, or analyze content across parent and child pages.
---

# Confluence Deep Reader

This skill guides you to recursively read Confluence pages and their descendants up to 3 levels deep.

## When to Use This Skill

Use this skill when:
- User provides a Confluence link and wants to read "everything" or "all related pages"
- User asks to "read this page and subpages"
- User wants to understand the full content tree of a Confluence page
- User needs comprehensive analysis of hierarchical documentation

## Workflow

### Step 1: Read the Starting Page

Use `getConfluencePage` to read the initial page provided by the user.

### Step 2: Discover Child Pages

Use `getConfluencePageDescendants` to find all child pages of the current page. This tool returns the hierarchical structure of descendants.

### Step 3: Read Each Child Page (Depth 1)

For each child page found:
1. Use `getConfluencePage` to read its content
2. Track that this is depth 1

### Step 4: Recursively Explore Deeper Levels

For each child page read in Step 3:
1. Use `getConfluencePageDescendants` to check if it has its own children
2. If children exist and current depth < 3:
   - Read each grandchild page (depth 2)
   - Repeat this process for depth 3

**IMPORTANT: Stop at depth 3.** Do not explore beyond 3 levels from the starting page.

### Step 5: Synthesize Information

After reading all pages within the depth limit:
1. Organize information hierarchically
2. Provide comprehensive summary or answer user's question
3. Note if there are deeper levels that were not explored (beyond depth 3)

## Depth Tracking

Keep track of the current depth level:
- **Depth 0**: Starting page (the one user provided)
- **Depth 1**: Direct children of starting page
- **Depth 2**: Grandchildren
- **Depth 3**: Great-grandchildren (STOP HERE)

## Best Practices

- **Show progress**: Let user know which pages you're reading (e.g., "Reading main page... Found 5 child pages... Reading child 1/5...")
- **Respect the limit**: Never go beyond depth 3
- **Be efficient**: If there are many pages (>20), consider asking user if they want to continue or focus on specific sections
- **Handle errors gracefully**: If a page cannot be accessed, note it and continue with others
- **Provide structure**: When presenting results, maintain the hierarchical structure so users understand the page relationships

## Example Usage

```
User: "Read this Confluence page and all its subpages: [link]"

Your workflow:
1. Read the starting page (depth 0)
2. Find its children using getConfluencePageDescendants
3. Read each child (depth 1) and find their children
4. Read each grandchild (depth 2) and find their children
5. Read each great-grandchild (depth 3) - STOP
6. Synthesize all information into a comprehensive summary
```

## When to Ask for Clarification

- If there are 50+ pages in the tree, ask if user wants to proceed with all or focus on specific branches
- If user asks for content "deeper than 3 levels", explain the limit and offer to focus on specific deep branches

© krafton-ai · Apache-2.0 · krafton-ai/KIRA

Similar skills

All skills for Writing and docs →
confluence membrane A skill for Claude Code, Codex, Cursor, GitHub Copilot, and other platforms that connects Confluence through the Membrane CLI. Membrane handles auth and token refresh, so the agent goes straight to working with documents. CX Codex +1 2,100installs confluence-expert Alireza Rezvani confluence-expert is a Claude Code skill for planning Confluence page trees, creating documentation templates, and auditing knowledge-base content during space restructuring or standards work. CX Codex +1 781installs confluence-assistant Waldemar Neto - github.com/waldemarnt confluence-assistant operates Confluence spaces through Atlassian MCP tools. Helps Claude Code search team documentation, create structured pages, and update existing entries using Markdown. CX Codex +1 ★ 7,191repo stars confluence-automation BuildWithClaude Community confluence-automation is a skill that creates, updates, and searches Confluence pages, and manages spaces, labels, and page hierarchies via Rube MCP. CX Codex +1 ★ 3,785repo stars atlassian-confluence mcparmory atlassian-confluence connects AI coding assistants to Confluence spaces to search docs, read attachments, and draft pages. Generated from the OpenAPI specification with automated tool testing. CX Codex +1 ★ 32repo stars confluence-to-markdown iurykrieger confluence-to-markdown is a Claude Code skill that reads a Confluence page and returns its content as Markdown. It runs as part of /bedrock:learn and /bedrock:sync. CX Codex +1 ★ 111repo stars

From the same set4

More in the catalog

Project sponsors

Companies that keep this analytics open