| name | confluence-admin |
| description | Confluence administration including users, groups, space settings, and permission diagnostics. Use when managing user access, group membership, viewing space configuration, or checking permissions.
|
| triggers | ["admin","administration","user management","group management","space settings","configure"] |
Confluence Admin Skill
Administration tools for Confluence Cloud covering user management, group management, space settings, and permission diagnostics.
PRIMARY USE CASE
This skill handles Confluence administration tasks. Use for:
- User search and information
- Group management and membership
- Space settings and configuration
- Permission diagnostics
When to Use / When NOT to Use
| Use This Skill | Use Instead |
|---|
| Space settings/configuration | - |
| User/group management | - |
| Permission diagnostics | - |
| View templates | - |
| Page content CRUD | confluence-page |
| Single page permissions | confluence-permission |
| Search content | confluence-search |
| Create pages from templates | confluence-template |
Risk Levels
| Operation | Risk | Notes |
|---|
| List users/groups | - | Read-only |
| View settings | - | Read-only |
| View templates | - | Read-only |
| Check permissions | - | Read-only |
| Update space settings | ⚠️ | Affects space behavior |
| Create groups | ⚠️ | Can be deleted |
| Modify group membership | ⚠️⚠️ | Affects access |
| Delete groups | ⚠️⚠️ | Affects access |
What This Skill Does
4 Major Administration Areas:
| Area | Commands | Key Operations |
|---|
| User Management | 3 | Search, view details, list groups |
| Group Management | 7 | Create, delete, manage membership |
| Space Administration | 3 | View settings, update, permissions |
| Templates & Permissions | 3 | List templates, check permissions |
When to Use This Skill
Reach for this skill when you need to:
User Management:
- Search for users by name or email
- View user details
- Check user's group memberships
Group Management:
- Create and delete groups
- Add/remove users from groups
- View group membership
Space Administration:
- View space settings
- Update space description
- View space permissions
Permission Diagnostics:
- Check what permissions you have on a space
- Diagnose access issues
Quick Start
confluence admin group list
confluence admin user search "john"
confluence admin space settings DOCS
confluence admin template list --space DOCS
Available Commands
All commands support --help for full documentation.
User Management
confluence admin user search "name or email"
confluence admin user search "john" --include-groups
confluence admin user search "john" --limit 50
confluence admin user get ACCOUNT_ID
confluence admin user groups ACCOUNT_ID
Options for user search:
--include-groups - Include group membership in results
--limit, -l - Maximum results (default: 25)
--output, -o - Output format: text or json
Group Management
confluence admin group list
confluence admin group list --limit 100
confluence admin group get "group-name"
confluence admin group members "group-name"
confluence admin group members "group-name" --limit 100
confluence admin group create "new-group-name"
confluence admin group delete "group-name" --confirm
confluence admin group add-user "group-name" --user "user@email.com"
confluence admin group remove-user "group-name" --user "user@email.com" --confirm
Options for group list:
--limit, -l - Maximum results (default: 50)
--output, -o - Output format: text or json
Options for group members:
--limit, -l - Maximum results (default: 50)
--output, -o - Output format: text or json
Space Administration
confluence admin space settings SPACEKEY
confluence admin space update SPACEKEY --description "New description"
confluence admin space permissions SPACEKEY
Templates
confluence admin template list
confluence admin template list --space DOCS
confluence admin template list --limit 100
confluence admin template get TEMPLATE_ID
Options for template list:
--space, -s - Filter by space key
--limit, -l - Maximum results (default: 50)
--output, -o - Output format: text or json
Permission Diagnostics
confluence admin permissions check --space DOCS
confluence admin permissions check --space DOCS --only-missing
Common Patterns
JSON Output for Scripting
confluence admin group list --output json
confluence admin user search "john" --output json
confluence admin template list --output json
Permission Requirements
| Operation | Required Permission |
|---|
| View settings | Space View |
| Update space | Space Admin |
| View templates | Space View |
| User/Group (read) | Browse Users |
| User/Group (write) | Site Admin |
Common Errors
| Error | Solution |
|---|
| 403 Forbidden | Verify you have Space Admin or Site Admin permission |
| 404 Not Found | Check space key, template ID, or user ID |
| 409 Conflict | Resource exists - choose different name |
| 400 Bad Request | Validate input format (see command --help) |
Troubleshooting
Diagnose Permission Issues
confluence admin permissions check --space DOCS
confluence admin permissions check --space DOCS --only-missing
confluence admin space permissions DOCS
confluence admin user groups YOUR_ACCOUNT_ID
Verify User Access
confluence admin user search "user@email.com"
confluence admin user groups ACCOUNT_ID
Exit Codes
| Code | Meaning |
|---|
| 0 | Success |
| 1 | General error |
| 2 | Permission denied |
| 3 | Resource not found |
| 4 | Validation error |
Related Skills
| Skill | Use Case |
|---|
| confluence-space | Create/delete spaces |
| confluence-page | Page CRUD |
| confluence-permission | Single-page permissions |
| confluence-bulk | Bulk operations |
| confluence-template | Create pages from templates |
| confluence-ops | Cache management |
Best Practices
Group Management Workflow
- Create role-based groups (viewers, editors, admins)
- Add users to appropriate groups:
confluence admin group add-user ...
- Verify membership:
confluence admin group members ...
Permission Diagnostics Workflow
- Check your permissions:
confluence admin permissions check --space DOCS
- Review space permissions:
confluence admin space permissions DOCS
- Verify group membership:
confluence admin user groups ACCOUNT_ID