Confluence Assistant

Confluence Assistant

The central hub skill that routes Confluence requests to specialized skills.

When to Use This Skill

Use this skill when you need to work with Confluence and are unsure which specific skill to use. This hub will intelligently route your request to the appropriate specialized skill based on keywords in your request.

Note: Trigger keywords are case-insensitive.

Quick Reference

Risk Levels: - (safe) | :warning: (reversible) | :warning::warning: (destructive) | :warning::warning::warning: (irreversible)

Explicit Routing Rules

Rule 1: Explicit Skill Mention Wins

If the user explicitly names a skill, route directly to it.

• "Use confluence-search to find pages" → confluence-search
• "I need confluence-page skill" → confluence-page

Rule 2: Entity Signals

Presence of identifiers suggests specific skills:

• Page ID (numeric) → likely confluence-page, confluence-comment, confluence-attachment
• Space key (uppercase) → likely confluence-space, confluence-search
• CQL query → confluence-search

Rule 3: Operation Keywords

Match verbs to skill domains:

• Create/update/delete/copy/move page → confluence-page
• Search/find/query/export → confluence-search
• Comment/reply/resolve → confluence-comment
• Upload/download/attach → confluence-attachment

Rule 4: Quantity Signals

Large-scale operations require bulk handling:

• Operations on 10+ items → confluence-bulk
• Bulk label operations → confluence-bulk
• Bulk delete/move → confluence-bulk
• "all pages in space" → confluence-bulk

Rule 5: Ambiguous Requests

When intent is unclear, ask for clarification rather than guessing.

Negative Triggers (What Each Skill Does NOT Handle)

Context Awareness

Pronoun Resolution

When users say "it", "this", "that", refer to the most recently mentioned resource:

• "Get page 12345" → "Update it" = Update page 12345
• "Search in DOCS space" → "Export those results" = Export DOCS search

Space Scope

Operations default to the current space context when established:

• "List pages in DOCS" → subsequent "create a page" assumes DOCS space

Context Expiration

Context clears when:

• User explicitly changes topic
• New space or page is explicitly mentioned
• Session restarts

Disambiguation Examples

Example 1: Ambiguous Target

User: "Show me the page"
→ Ambiguous: Which page?
→ Ask: "Which page would you like to see? Please provide the page ID or title."

Example 2: Missing Operation

User: "Page 12345"
→ Ambiguous: What operation?
→ Ask: "What would you like to do with page 12345? (get, update, delete, etc.)"

Example 3: Skill Overlap

User: "Find the comments"
→ Ambiguous: Search for pages with comments, or list comments on a page?
→ Ask: "Would you like to search for pages containing comments, or list comments on a specific page?"

Example 4: Destructive Operation Confirmation

User: "Delete all pages in ARCHIVE"
→ Destructive operation detected
→ Ask: "This will delete all pages in ARCHIVE space. Are you sure? Please confirm with 'yes' to proceed."

Common Workflows

Workflow 1: Create and Configure a New Page

1. confluence-page - Create the page with content
2. confluence-label - Add relevant labels
3. confluence-permission - Set page restrictions if needed

Workflow 2: Content Audit

1. confluence-search - Find pages matching criteria
2. confluence-analytics - Check view counts and activity
3. confluence-label - Tag pages based on audit findings

Workflow 3: Space Migration

1. confluence-search - Find all pages in source space
2. confluence-page - Copy pages to destination space
3. confluence-attachment - Verify attachments transferred
4. confluence-hierarchy - Confirm parent-child relationships

Workflow 4: Documentation Review

1. confluence-search - Find pages by label (e.g., "needs-review")
2. confluence-comment - Add review comments
3. confluence-label - Update labels (remove "needs-review", add "reviewed")

Overview

This skill acts as the main entry point for Confluence operations, intelligently routing requests to the appropriate specialized skill based on the user's intent.

Available Skills

Routing Logic

The assistant uses keyword matching to route requests:

Page Operations

• Keywords: page, blog, create, update, delete, copy, move, version, read, get, edit, remove, duplicate, relocate, revert, restore
• Routes to: confluence-page

Space Operations

• Keywords: space, spaces, create space, list space, get space, show spaces, update space, edit space, delete space, remove space, space settings, space content, space pages
• Routes to: confluence-space

Search Operations

• Keywords: search, find, query, CQL, export, find content, saved search, search by label
• Routes to: confluence-search

Comment Operations

• Keywords: comment, comments, reply, inline, resolve, footer comment, get comments, update comment, delete comment
• Routes to: confluence-comment

Attachment Operations

• Keywords: attach, upload, download, file, attachment, attachments
• Routes to: confluence-attachment

Label Operations

• Keywords: label, labels, tag, tags
• Routes to: confluence-label

Template Operations

• Keywords: template, templates, blueprint, from template, page template, list templates, update template, create from template
• Routes to: confluence-template

Property Operations

• Keywords: property, properties, metadata, custom data, content property, page property, set property, get property, delete property, list properties
• Routes to: confluence-property

Permission Operations

• Keywords: permission, permissions, restrict, access, security
• Routes to: confluence-permission

Analytics Operations

• Keywords: analytics, views, statistics, popular, watchers, contributors, page views, space analytics, most viewed, most popular, who is watching, content analytics
• Routes to: confluence-analytics

Watch Operations

• Keywords: watch, unwatch, notify, follow, notifications
• Routes to: confluence-watch

Hierarchy Operations

• Keywords: parent, children, child, tree, ancestor, descendant, hierarchy, breadcrumb, navigation, reorder
• Routes to: confluence-hierarchy

JIRA Operations

• Keywords: jira, issue, embed jira, jira macro, jira issues, link jira
• Routes to: confluence-jira

Bulk Operations

• Keywords: bulk, batch, multiple pages, mass, all pages, many pages, bulk delete, bulk label, bulk move, bulk update
• Routes to: confluence-bulk

Operations/Cache

• Keywords: cache, cache status, cache clear, cache warm, performance, rate limit, health check, diagnostics, troubleshoot
• Routes to: confluence-ops

Administration

• Keywords: admin, administration, user management, group management, groups, users, site settings, space settings, configure, setup
• Routes to: confluence-admin

Configuration

Authentication Setup

1. Get an API token from https://id.atlassian.com/manage-profile/security/api-tokens

2. Set environment variables:

export CONFLUENCE_SITE_URL="https://your-site.atlassian.net"
export CONFLUENCE_EMAIL="your-email@company.com"
export CONFLUENCE_API_TOKEN="your-api-token"

3. Or create .claude/settings.local.json:

{
  "confluence": {
    "url": "https://your-site.atlassian.net",
    "email": "your-email@company.com",
    "api_token": "your-api-token"
  }
}

Example Commands

Page Operations

• "Create a new page called 'Meeting Notes' in DOCS space"
• "Update page 12345 with new content"
• "Delete page 12345"
• "Copy page 12345 to ARCHIVE space"

Space Operations

• "List all spaces"
• "Create a new space for the Engineering team"
• "Show me the contents of DOCS space"

Search Operations

• "Search for pages about API documentation"
• "Find all pages with label 'approved'"
• "Export all pages in KB space to CSV"

Comment Operations

• "Add a comment to page 12345"
• "Show me comments on page 12345"
• "Resolve the inline comment"

Attachment Operations

• "Upload report.pdf to page 12345"
• "Download all attachments from page 12345"
• "List attachments on page 12345"

Label Operations

• "Add label 'approved' to page 12345"
• "Find all pages with label 'documentation'"
• "Remove label 'draft' from page 12345"

Hierarchy Operations

• "Show me the child pages of 12345"
• "Get the parent pages of 67890"
• "Display the page tree for DOCS space"

Template Operations

• "List all templates in DOCS space"
• "Create a page from the 'Meeting Notes' template"
• "Show available blueprints"
• "Update the 'Project Kickoff' template"

Property Operations

• "Set property 'status' to 'approved' on page 12345"
• "Get all properties from page 12345"
• "List properties on page 12345"
• "Delete the 'draft' property from page 12345"

Analytics Operations

• "Show me the view count for page 12345"
• "Who has viewed page 12345?"
• "What are the most viewed pages in DOCS space?"
• "Show watchers and contributors for page 12345"

Watch Operations

• "Watch page 12345"
• "Unwatch page 12345"
• "Who is watching page 12345?"
• "Follow space DOCS"

JIRA Integration Operations

• "Embed JIRA issue PROJ-123 in page 12345"
• "Show JIRA issues linked to page 12345"
• "Add a JIRA macro for project PROJ to the page"
• "Link page 12345 to JIRA issue DEV-456"

Bulk Operations

• "Bulk delete all pages in ARCHIVE space with dry-run"
• "Add label 'approved' to all pages in DOCS space"
• "Move all pages with label 'old' to ARCHIVE space"
• "Bulk update permissions on pages in INTERNAL"

Operations/Cache

• "Check cache status"
• "Clear the cache"
• "Warm the cache for DOCS space"
• "Run a health check on Confluence connectivity"
• "Check rate limit status"

Administration Operations

• "List all groups"
• "Search for user john@example.com"
• "Add user to engineering group"
• "View space settings for DOCS"
• "Create a new template"

API Reference

This skill uses the Confluence Cloud REST API:

• v2 API (primary): /api/v2/*

  • Pages, Spaces, Blog Posts, Comments, Attachments, Labels

• v1 API (legacy/fallback): /rest/api/*

  • Search (CQL), Content Properties, Space Settings

Documentation: https://developer.atlassian.com/cloud/confluence/rest/v2/intro/

Error Handling

The assistant provides clear error messages for common issues:

• 401 Unauthorized: Check your API token and email
• 403 Forbidden: You don't have permission for this operation
• 404 Not Found: The resource doesn't exist
• 429 Rate Limited: Wait before retrying
• 5xx Server Error: Confluence server issue

Getting Help

• Use /help for general Claude Code help
• Check CLAUDE.md for project documentation
• See skill-specific SKILL.md files for detailed usage