Skill

confluence-page

Manage Confluence pages and blog posts - create, read, update, delete, copy, move, and version control. ALWAYS use when user wants to work with page content, create pages, update pages, or manage page versions.

Install

npx claudepluginhub grandcamel/confluence-assistant-skills --plugin confluence-assistant-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Manage Confluence pages and blog posts through natural language commands.

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

169.2k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

169.2k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

169.2k

Stats

Stars2

Forks1

Last CommitJan 31, 2026

Actions

View Source View Plugin View on GitHub View README

Confluence Page Skill

Manage Confluence pages and blog posts through natural language commands.

⚠️ PRIMARY USE CASE

This is the core skill for all page and blog post operations. Use this skill whenever you need to:

Create, read, update, or delete pages
Create or manage blog posts
Copy or move pages between spaces
Access or restore version history

When to Use This Skill

Trigger	Example
Page CRUD	"Create a page", "Get page 12345", "Update the page", "Delete this page"
Blog posts	"Create a blog post", "Get blog 67890"
Copy/Move	"Copy page to ARCHIVE", "Move page under parent 12345"
Versions	"Show version history", "Restore to version 5"
Content from files	"Create page from markdown file", "Update page from content.md"

When NOT to Use This Skill

Operation	Use Instead
Search for pages	`confluence-search`
Add comments to pages	`confluence-comment`
Upload attachments	`confluence-attachment`
Add/remove labels	`confluence-label`
Set page restrictions	`confluence-permission`
View page analytics	`confluence-analytics`
Watch/unwatch pages	`confluence-watch`
Navigate page hierarchy	`confluence-hierarchy`

Risk Levels

Operation	Risk	Notes
Get page	-	Read-only
Create page	-	Easily deletable
Update page	⚠️	Creates version history, reversible
Copy page	-	Creates new page
Move page	⚠️	Can be moved back
Delete page	⚠️⚠️	Goes to trash, recoverable for 30 days
Permanent delete	⚠️⚠️⚠️	IRREVERSIBLE

Overview

This skill handles all CRUD operations for Confluence pages and blog posts, including:

Creating new pages and blog posts
Reading page content and metadata
Updating page content, title, and status
Deleting pages (trash or permanent)
Copying and moving pages
Version history and restoration

CLI Commands

confluence page create

Create a new Confluence page.

Usage:

# Create a simple page
confluence page create --space DOCS --title "My New Page" --body "Page content here"

# Create with parent page
confluence page create --space DOCS --title "Child Page" --parent 12345 --body "Content"

# Create from Markdown file
confluence page create --space DOCS --title "From Markdown" --file content.md

# Create as draft
confluence page create --space DOCS --title "Draft Page" --body "WIP" --status draft

Arguments:

--space, -s - Space key (required)
--title, -t - Page title (required)
--body, -b - Page body content
--file, -f - Read body from file (Markdown supported)
--parent, -p - Parent page ID
--status - Page status: current (default) or draft
--output, -o - Output format: text or json

confluence page get

Retrieve a page's content and metadata.

Usage:

# Get by page ID
confluence page get 12345

# Get with full body content
confluence page get 12345 --body

# Get specific body format
confluence page get 12345 --body --format markdown

# JSON output
confluence page get 12345 --output json

Arguments:

page_id - Page ID (required)
--body - Include body content
--format - Body format: storage (default), view, or markdown
--output, -o - Output format: text or json

confluence page update

Update an existing page.

Usage:

# Update title
confluence page update 12345 --title "New Title"

# Update body
confluence page update 12345 --body "New content"

# Update from file
confluence page update 12345 --file updated-content.md

# Update with version message
confluence page update 12345 --body "Updated" --message "Fixed typos"

# Change status
confluence page update 12345 --status draft

Arguments:

page_id - Page ID (required)
--title, -t - New title
--body, -b - New body content
--file, -f - Read body from file
--message, -m - Version message
--status - New status: current or draft
--output, -o - Output format

confluence page delete

Delete a page (move to trash or permanent delete).

Usage:

# Move to trash (default)
confluence page delete 12345

# Permanent delete
confluence page delete 12345 --permanent

# Force without confirmation
confluence page delete 12345 --force

Arguments:

page_id - Page ID (required)
--permanent - Permanently delete (cannot be recovered)
--force, -f - Skip confirmation prompt

confluence page blog create

Create a new blog post.

Usage:

confluence page blog create --space BLOG --title "My Blog Post" --body "Blog content"

# From Markdown
confluence page blog create --space BLOG --title "From MD" --file post.md

Arguments:

--space, -s - Space key (required)
--title, -t - Blog post title (required)
--body, -b - Blog post content
--file, -f - Read body from file
--output, -o - Output format

confluence page blog get

Retrieve a blog post.

Usage:

confluence page blog get 67890 --body

Arguments:

blogpost_id - Blog post ID (required)
--body - Include body content
--format - Body format
--output, -o - Output format

confluence page copy

Copy a page to a new location.

Usage:

# Copy to same space
confluence page copy 12345 --title "Page Copy"

# Copy to different space
confluence page copy 12345 --title "Page Copy" --space NEWSPACE

# Copy with children
confluence page copy 12345 --title "Page Copy" --include-children

Arguments:

page_id - Source page ID (required)
--title, -t - New page title (default: "Copy of [original]")
--space, -s - Target space key
--parent, -p - Target parent page ID
--include-children - Copy child pages recursively
--output, -o - Output format

confluence page move

Move a page to a new location.

Usage:

# Move to new parent
confluence page move 12345 --parent 67890

# Move to different space
confluence page move 12345 --space NEWSPACE

# Move to space root
confluence page move 12345 --space NEWSPACE --root

Arguments:

page_id - Page ID to move (required)
--space, -s - Target space key
--parent, -p - Target parent page ID
--root - Move to space root (no parent)

confluence page versions

Get version history for a page.

Usage:

# List all versions
confluence page versions 12345

# Limit results
confluence page versions 12345 --limit 10

# Show version details
confluence page versions 12345 --detailed

Arguments:

page_id - Page ID (required)
--limit, -l - Maximum versions to return
--detailed - Show full version details
--output, -o - Output format

confluence page restore

Restore a page to a previous version.

Usage:

# Restore to version 5
confluence page restore 12345 --version 5

# With version message
confluence page restore 12345 --version 5 --message "Restoring to known good state"

Arguments:

page_id - Page ID (required)
--version, -v - Version number to restore (required)
--message, -m - Version message for the restoration

Examples

Natural Language Triggers

"Create a new page called 'Meeting Notes' in the DOCS space"
"Get the content of page 12345"
"Update page 12345 with this content: [content]"
"Delete the page with ID 12345"
"Create a blog post titled 'Sprint Review' in TEAM space"
"Copy page 12345 to the ARCHIVE space"
"Move page 12345 under parent page 67890"
"Show me the version history for page 12345"
"Restore page 12345 to version 3"

Common Workflows

Create a page from natural language:

User: Create a page called "API Documentation" in DOCS space with content explaining our REST API

Common Pitfalls

1. Page ID vs Page Title

Problem: Trying to use page title when page ID is required
Solution: Use confluence search cql "title = 'Page Name'" to find the page ID first

2. Version Conflicts

Problem: Update fails due to concurrent edits (409 Conflict)
Solution: Get the latest version, merge changes, retry update

3. Missing Parent Page

Problem: Creating a child page with invalid parent ID
Solution: Verify parent exists with confluence page get PARENT_ID

4. Content Format Mismatch

Problem: Body content not rendering correctly
Solution: Use --file with Markdown, or ensure proper ADF/storage format

5. Space Key Case Sensitivity

Problem: Space key not found
Solution: Space keys are case-sensitive (use uppercase: DOCS not docs)

6. Permanent Delete Recovery

Problem: Accidentally used --permanent flag
Solution: No recovery possible - always use trash (default) first

7. Blog Post Update/Delete

Problem: Trying to update or delete a blog post using page commands
Solution: Blog posts currently only support create and get operations via CLI. Update/delete must be done via Confluence UI.

Error Handling

Error	Cause	Resolution
404 Not Found	Page ID doesn't exist or was deleted	Verify page ID, check trash
403 Forbidden	No permission to access/modify page	Request space access, check restrictions
409 Conflict	Concurrent edit detected	Refresh page, merge changes, retry
400 Bad Request	Invalid content format or parameters	Check body format, verify arguments
413 Content Too Large	Page body exceeds size limit	Split content across multiple pages

Recovery from Errors

Deleted page recovery:

# Pages go to trash by default (recoverable for 30 days)
# Use Confluence UI: Space Settings > Content Tools > Trash > Restore

Version recovery:

# Check version history
confluence page versions 12345

# Restore previous version
confluence page restore 12345 --version 5

Permission issues:

# Check page restrictions
confluence permission page get 12345

# Check space permissions
confluence permission space get SPACE_KEY