Skill

export-by-label

Export Confluence pages by label. Usage: /confluence-export-kit:export-by-label <label> [output-path] [--space-key <KEY>] [--dry-run]

Install

npx claudepluginhub inkwonjung-colosseum/plugins --plugin confluence-export-kit

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Search Confluence pages by label and export only the matched pages with `cme pages`.

Supporting Assets

scripts/export_by_label.py

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

163.7k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

163.7k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

163.7k

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitApr 23, 2026

Actions

View Source View Plugin View on GitHub View README

Export By Label

Search Confluence pages by label and export only the matched pages with cme pages.

Invocation

Primary usage:

/confluence-export-kit:export-by-label <label>

Optional output override:

/confluence-export-kit:export-by-label <label> <output-path>

Limit search to a specific space:

/confluence-export-kit:export-by-label <label> --space-key <SPACEKEY>

Preview matched pages without exporting:

/confluence-export-kit:export-by-label <label> --dry-run

Rules

Treat $ARGUMENTS[0] as the Confluence label name to search.
Treat $ARGUMENTS[1] as an optional export output path override.
Default target is CONFLUENCE_EXPORT_KIT_BASE_URL, then https://colosseum.atlassian.net. Override via --site.
Before export, validate that Python, pipx, and cme are usable.
Read the cme config file and verify that the target site already has a configured auth.confluence entry with both username and api_token.
If auth is missing or incomplete, stop and tell the user to run:

/confluence-export-kit:set-api-key <api-key> <email>

Search Confluence with CQL: type = page and label = "<label>".
If --space-key <SPACEKEY> is provided, add and space = "<SPACEKEY>" to the CQL query.
If --dry-run is set, print the matched page URLs and stop without running the export.
Export only the matched pages. Do not export descendants.
If an output path was supplied, apply it only for this export via environment override. Do not persistently rewrite the user's cme config.
--skip-unchanged / --no-skip-unchanged — skips pages whose version matches the lockfile (incremental export). Default: on.
--cleanup-stale / --no-cleanup-stale — removes local files for pages deleted or moved in Confluence. Default: on.
--jira-enrichment fetches Jira issue summaries and includes them in the exported Markdown.
Do not print stored secrets.

Execution

Step 1 — Python availability check

Before running any script, verify Python is installed:

python3 --version

If this fails, stop and tell the user:

Python is not installed. Install Python 3.10+ before continuing:

macOS: brew install python or download from https://www.python.org/downloads/

Windows: Download from https://www.python.org/downloads/ (check "Add to PATH" during install)

Linux: sudo apt install python3 (Debian/Ubuntu) or sudo dnf install python3 (Fedora)

Do not proceed to Step 2 until Python is available.

Step 2 — Run the helper script

If no label argument was provided, stop and tell the user to run:

/confluence-export-kit:export-by-label <label> [output-path] [--space-key <KEY>] [--dry-run]

Otherwise run the helper script in this skill directory:

python3 "${CLAUDE_SKILL_DIR}/scripts/export_by_label.py" "<label>" ["<output-path>"] [--space-key "<SPACEKEY>"] [--dry-run] [--no-skip-unchanged] [--no-cleanup-stale] [--jira-enrichment]

Response Format

After the script finishes:

report Python/pipx/cme preflight status
report the Confluence site used
confirm that auth was already configured
report the label searched and any space key filter applied
report how many pages matched
if dry-run: list all matched URLs and note that export was skipped
if not dry-run: report the effective export output path and confirm export completed