From confluence-tools
This skill MUST be used when the user asks to "create a Confluence folder", "make a folder in wiki", "organize pages", or wants to create organizational structure in Confluence. Creates true Confluence folders only (no fallback to pages).
npx claudepluginhub ericfisherdev/claude-plugins --plugin confluence-toolsThis skill uses the workspace's default tool permissions.
**IMPORTANT:** This skill creates true Confluence folders using the Confluence Cloud folders API. It does NOT fall back to creating pages as containers - if folder creation fails, it will provide clear error messages and suggestions.
Verifies tests pass on completed feature branch, presents options to merge locally, create GitHub PR, keep as-is or discard; executes choice and cleans up worktree.
Guides root cause investigation for bugs, test failures, unexpected behavior, performance issues, and build failures before proposing fixes.
Writes implementation plans from specs for multi-step tasks, mapping files and breaking into TDD bite-sized steps before coding.
IMPORTANT: This skill creates true Confluence folders using the Confluence Cloud folders API. It does NOT fall back to creating pages as containers - if folder creation fails, it will provide clear error messages and suggestions.
Use the Python script at scripts/create_confluence_folder.py:
# Create folder in a space
python scripts/create_confluence_folder.py --space DEV --title "Documentation"
# Create nested folder under existing folder
python scripts/create_confluence_folder.py --space DEV --title "API Docs" --parent 123456
| Option | Description |
|---|---|
--space, -s | Space key (required) |
--title, -t | Folder title (required) |
--parent, -p | Parent folder ID (creates nested folder) |
--parent-title | Parent folder title (alternative to ID) |
--format, -f | Output: compact (default), text, json |
True folders only - This skill only creates true Confluence folders. It will NOT silently create pages as a fallback.
Folder API availability - The Confluence folders API is available in Confluence Cloud. If folder creation fails, the script will provide helpful error messages.
Nesting folders - When creating nested folders, the parent must be an existing folder (not a page).
# Create root folders in a space
python scripts/create_confluence_folder.py --space DEV --title "Architecture"
python scripts/create_confluence_folder.py --space DEV --title "API Documentation"
python scripts/create_confluence_folder.py --space DEV --title "Guides"
# Create a parent folder first
python scripts/create_confluence_folder.py --space DEV --title "Documentation"
# Then create child folders under it (use the ID from the previous command)
python scripts/create_confluence_folder.py --space DEV --title "v1" --parent 123456
python scripts/create_confluence_folder.py --space DEV --title "v2" --parent 123456
compact (default):
FOLDER|123456|Documentation|DEV
URL:https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123456
text:
Folder Created: Documentation
ID: 123456
Space: DEV
Type: folder
URL: https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123456
json:
{"id":"123456","title":"Documentation","space":"DEV","type":"folder","url":"..."}
If folder creation fails, the script will:
Common errors:
Requires environment variables:
CONFLUENCE_BASE_URL - e.g., https://yoursite.atlassian.netCONFLUENCE_EMAIL - Your Atlassian account emailCONFLUENCE_API_TOKEN - API token from Atlassian account settingsFor detailed options, see references/options-reference.md.