confluence-space

# 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 | Trigger | Example | |---------|---------| | Create space | "Create a new space for the engineering team" | | List spaces | "Show me all spaces", "List global spaces" | | Get space | "Get details for DOCS space" | | Space content | "What pages are in KB space?" | | Update space | "Change the name of space DOCS" | | Delete space | "Delete the TEST space" | --- ## When NOT to Use This Skill | Operation | Use Instead | |-----------|-------------| | Create/edit individual pages | `confluence-page` | | Search within a space | `confluence-search` | | Set space permissions | `confluence-permission` | | Navigate page hierarchy | `confluence-hierarchy` | --- ## Risk Levels | Operation | Risk | Notes | |-----------|------|-------| | List/get spaces | - | Read-only | | Create space | - | Can be deleted | | Update space | ⚠️ | Changes can be reverted | | Get space content | - | Read-only | | Delete space | ⚠️⚠️⚠️ | **IRREVERSIBLE - ALL CONTENT LOST** | --- ## 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:** ```bash # 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:** ```bash 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:** ```bash # 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:** ```bash 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:** ```bash 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:** ```bash # 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:** ```bash 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 | Error | Cause | Resolution | |-------|-------|------------| | **404 Not Found** | Space doesn't exist | Verify space key with `confluence-as space list` | | **403 Forbidden** | No permission to access/modify space | Request space admin access | | **409 Conflict** | Space key already exists | Use a different, unique key | | **400 Bad Request** | Invalid space key format | Start with a letter; letters, numbers, and underscores only | ### 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:** ```bash # Check current space permissions confluence-as permission space get SPACE_KEY # Request admin access from space administrator ```