This Claude skill automates the management of Atlassian Confluence content by providing a robust interface for deleting pages and folders. It streamlines wiki maintenance through intelligent content-type auto-detection and structured deletion workflows, helping teams maintain a clean and organized knowledge base with minimal manual effort.

When should I use delete-page?

delete-page is useful in the following scenarios: • Workspace Cleanup: Efficiently remove outdated, redundant, or archived wiki pages during periodic documentation audits. • Project Decommissioning: Automatically delete temporary project folders and scratchpad pages once a project reaches its end-of-life. • Recursive Content Removal: Safely handle complex folder hierarchies by identifying and deleting child pages before removing parent containers. • Data Retention Compliance: Programmatically enforce data policies by removing sensitive or expired information from the corporate wiki.

name	delete-page
description	This skill MUST be used when the user asks to "delete a Confluence page", "remove a page", "delete a folder", "remove content from wiki", or wants to delete pages or folders from Confluence. ALWAYS use this skill for Confluence content deletion.

Delete Confluence Page or Folder

IMPORTANT: Always use this skill's Python script for deleting Confluence pages and folders. This skill auto-detects content type and handles both pages and folders.

Quick Start

Use the Python script at scripts/delete_confluence_page.py:

# Delete a page (auto-detect type)
python scripts/delete_confluence_page.py --id 123456

# Delete a folder explicitly
python scripts/delete_confluence_page.py --id 123456 --type folder

# Delete a page explicitly
python scripts/delete_confluence_page.py --id 123456 --type page

Options

Option	Description
`--id`, `-i`	Page or folder ID to delete (required)
`--type`, `-t`	Content type: page, folder, auto (default: auto)
`--format`, `-f`	Output: compact (default), text, json

Important Notes

Children must be deleted first - You cannot delete a page or folder that has children. Delete the children first, or delete recursively starting from the deepest level.
Deletion is permanent - Deleted content goes to the trash but should be treated as permanent. Use with caution.
Auto-detection - By default, the script tries to find the content as a page first, then as a folder. Use --type to skip auto-detection if you know the type.

Common Workflows

Delete a Single Page

python scripts/delete_confluence_page.py --id 123456

Delete a Folder Structure (Bottom-Up)

When deleting a folder hierarchy, delete children first:

# First delete all pages in the folder
python scripts/delete_confluence_page.py --id 123459  # Child page 1
python scripts/delete_confluence_page.py --id 123460  # Child page 2

# Then delete the folder itself
python scripts/delete_confluence_page.py --id 123458 --type folder

Delete Multiple Pages

# Delete several pages
for id in 123456 123457 123458; do
  python scripts/delete_confluence_page.py --id $id
done

Output Formats

compact (default):

DELETED|123456|page|My Page Title

text:

Deleted: My Page Title
ID: 123456
Type: page

json:

{"id": "123456", "title": "My Page Title", "type": "page", "deleted": true}

Error Handling

Error	Cause	Solution
"not found"	ID doesn't exist	Verify the ID is correct
"has children"	Content has child pages	Delete children first
"permission denied"	No delete permission	Check your permissions

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

delete-page

When & Why to Use This Skill

Use Cases