Confluence Space Skill

Manage Confluence spaces through natural language commands.

⚠️ PRIMARY USE CASE

This skill manages Confluence spaces (containers for pages). Use this skill for:

• Creating new spaces
• Listing and browsing spaces
• Updating space properties (name, description, homepage)
• Viewing space content summary
• Deleting spaces (⚠️⚠️⚠️ IRREVERSIBLE)

When to Use This Skill

When NOT to Use This Skill

Risk Levels

Overview

This skill handles all space management operations, including:

• Creating new spaces
• Listing and searching spaces
• Updating space properties
• Deleting spaces
• Viewing space content and settings

CLI Commands

Output format tip: A global -o/--output flag placed before the subcommand (e.g. confluence-as -o json space list) sets the default output format for all subcommands; an explicit subcommand-level --output wins.

confluence-as space create

Create a new Confluence space.

Usage:

# Create a basic space
confluence-as space create --key DOCS --name "Documentation"

# Create with description
confluence-as space create --key KB --name "Knowledge Base" --description "Company knowledge base"

# Create personal space
confluence-as space create --key JSMITH --name "Personal Space" --type personal

Arguments:

• --key, -k - Space key (required, 2-255 chars, alphanumeric)
• --name, -n - Space name (required)
• --description, -d - Space description
• --type - Space type: global (default) or personal
• --output, -o - Output format: text or json

confluence-as space get

Retrieve space details.

Usage:

confluence-as space get DOCS
confluence-as space get DOCS --output json

Arguments:

• space_key - Space key (required)
• --output, -o - Output format

confluence-as space list

List all accessible spaces.

Usage:

# List all spaces
confluence-as space list

# Filter by type
confluence-as space list --type global

# Search by name
confluence-as space list --query "docs"

# Limit results
confluence-as space list --limit 10

Arguments:

• --type - Filter by type: global or personal
• --query, -q - Search query
• --status - Filter by status: current or archived
• --limit, -l - Maximum results
• --output, -o - Output format

confluence-as space update

Update space properties.

Usage:

confluence-as space update DOCS --name "New Name"
confluence-as space update DOCS --description "Updated description"
confluence-as space update DOCS --homepage 12345

Arguments:

• space_key - Space key (required)
• --name, -n - New space name
• --description, -d - New description
• --homepage - Homepage page ID
• --output, -o - Output format

confluence-as space delete

Delete a space.

Usage:

confluence-as space delete DOCS
confluence-as space delete DOCS --force

Arguments:

• space_key - Space key (required)
• --force, -f - Skip confirmation

confluence-as space content

List pages in a space.

Usage:

# List all pages
confluence-as space content DOCS

# Filter to root-level pages only
confluence-as space content DOCS --depth root

# Include archived
confluence-as space content DOCS --include-archived

Arguments:

• space_key - Space key (required)
• --depth - Tree depth: root, children, or all (only root currently applies filtering; children/all return all content)
• --status - Filter by status (current, archived, draft)
• --include-archived - Include archived content
• --limit, -l - Maximum results
• --output, -o - Output format

confluence-as space settings

Get space settings and theme.

Usage:

confluence-as space settings DOCS

Arguments:

• space_key - Space key (required)
• --output, -o - Output format

Examples

Natural Language Triggers

• "Create a new space called 'Engineering Docs' with key ENG"
• "List all spaces"
• "Get details for space DOCS"
• "Show me all pages in the KB space"
• "Update space DOCS with new description"
• "Delete space TEST"

Common Workflows

Create and configure a space:

User: Create a documentation space for the API team

Common Pitfalls

1. Space Key Restrictions

• Problem: Space creation fails with invalid key
• Solution: Keys must be 2-255 chars, start with a letter, and contain only letters, numbers, and underscores; lowercase input is uppercased automatically

2. Duplicate Space Key

• Problem: Space key already exists
• Solution: Use unique keys, check existing spaces first with confluence-as space list

3. Deleting Non-Empty Spaces

• Problem: Accidentally deleting a space with important content
• Solution: Space deletion is PERMANENT - export content first, double-check space key

4. Personal Space Naming

• Problem: Personal space creation fails with a key like ~username
• Solution: The CLI rejects ~ prefixes - use a normal alphanumeric key (starting with a letter) together with --type personal

5. Homepage Not Found

• Problem: Setting homepage fails with 404
• Solution: Homepage page ID must be a page within the same space

Error Handling

Recovery from Errors

Accidentally deleted space:

⚠️⚠️⚠️ SPACE DELETION IS PERMANENT - NO RECOVERY POSSIBLE

Prevention:
- Always export space content before deletion
- Use --force flag only when absolutely certain
- Consider archiving instead of deleting

Space permission issues:

# Check current space permissions
confluence-as permission space get SPACE_KEY

# Request admin access from space administrator