---

name: confluence-page description: This skill MUST be used when the user asks to "get a Confluence page", "fetch page content", "show me the wiki page", "read Confluence page", "view page", or mentions a Confluence page ID or wants to retrieve page information. ALWAYS use this skill for Confluence page retrieval.

Confluence Page Retrieval

IMPORTANT: Always use this skill's Python script for fetching Confluence pages. This skill uses caching to reduce API calls and provides token-efficient output with configurable truncation.

Quick Start

Use the Python script at scripts/fetch_confluence_page.py:

Copy# Fetch page by ID
python scripts/fetch_confluence_page.py 123456

# Fetch page by title in a space
python scripts/fetch_confluence_page.py --space DEV --title "Architecture Overview"

# Minimal output (~30 tokens)
python scripts/fetch_confluence_page.py 123456 --preset minimal

# Full content with ancestors
python scripts/fetch_confluence_page.py 123456 --preset full

Presets

Options

Output Formats

compact (default):

CopyPAGE|123456|Architecture Overview|DEV|current
Body: This document describes the system architecture...
URL:https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123456

text:

CopyPage: Architecture Overview
ID: 123456
Space: DEV
Status: current
Version: 5
Body: This document describes the system architecture...
URL: https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123456

json:

Copy{"id":"123456","title":"Architecture Overview","space":"DEV","status":"current","body":"...","url":"..."}

Common Workflows

Quick Page Lookup

Copy# Get just the URL and title
python scripts/fetch_confluence_page.py 123456 --preset minimal

Read Full Documentation

Copy# Get full page content with context
python scripts/fetch_confluence_page.py 123456 --preset full

Find Page by Name

Copy# Search for a page in a specific space
python scripts/fetch_confluence_page.py --space DEV --title "API Documentation"

Cache

Pages are cached for 1 hour at ~/.confluence-tools-cache.json.

Manage cache:

Copypython shared/confluence_cache.py info    # View cache status
python shared/confluence_cache.py clear   # Clear cache

Environment Setup

Requires environment variables:

• CONFLUENCE_BASE_URL - e.g., https://yoursite.atlassian.net
• CONFLUENCE_EMAIL - Your Atlassian account email
• CONFLUENCE_API_TOKEN - API token from Atlassian account settings

Reference

For detailed options, see references/options-reference.md.