confluence

SKILL.md

Confluence

Search and manage Confluence pages using confluence-cli.

REQUIRED: First-Time Setup

Before using this skill, complete these steps:

Step 1: Install the CLI

npm install -g confluence-cli

Step 2: Get an API token

  1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
  2. Click "Create API token"
  3. Give it a label (e.g., "confluence-cli")
  4. Copy the token

Step 3: Configure the CLI

confluence init

When prompted, enter:

  • Domain: yourcompany.atlassian.net (without https://)
  • Email: Your Atlassian account email
  • API token: Paste the token from Step 2

Step 4: Verify setup

confluence spaces

If you see your spaces listed, you're ready to use Confluence.


Search Pages

confluence search "deployment guide"

Read Page

confluence read <page-id>

Page IDs are in the URL: https://yoursite.atlassian.net/wiki/spaces/SPACE/pages/123456/Title → ID is 123456

Get Page Info

confluence info <page-id>

Find Page by Title

confluence find "Page Title"

List Spaces

confluence spaces

Create Page

confluence create "Page Title" SPACEKEY --body "Page content here"

Create Child Page

confluence create-child "Child Page Title" <parent-page-id> --body "Content"

Or from a file:

confluence create-child "Page Title" <parent-id> --file content.html --format storage

Update Page

confluence update <page-id> --body "Updated content"

Or from a file:

confluence update <page-id> --file content.html --format storage

List Child Pages

confluence children <page-id>

Export Page with Attachments

confluence export <page-id> --output ./exported-page/

Tips

  • Domain in config should NOT include https:// - just yourcompany.atlassian.net
  • Use --format storage when content is in Confluence storage format (HTML-like)
  • Page IDs are numeric and found in page URLs
  • Config is stored at ~/.confluence-cli/config.json
Weekly Installs
3
Repository
clawdbot/skills
Installed on
opencode2
windsurf1
clawdbot1
trae1
codex1
claude-code1