confluence-page

Files (1)

• SKILL.md

SKILL.md (first lines)

# Confluence Page Skill

Manage Confluence pages and blog posts through natural language commands.

---

## ⚠️ PRIMARY USE CASE

**This is the core skill for all page and blog post operations.** Use this skill whenever you need to:
- Create, read, update, or delete pages
- Create or manage blog posts
- Copy or move pages between spaces
- Access or restore version history

---

## When to Use This Skill

| Trigger | Example |
|---------|---------|
| Page CRUD | "Create a page", "Get page 12345", "Update the page", "Delete this page" |
| Blog posts | "Create a blog post", "Get blog 67890" |
| Copy/Move | "Copy page to ARCHIVE", "Move page under parent 12345" |
| Versions | "Show version history", "Restore to version 5" |
| Content from files | "Create page from markdown file", "Update page from content.md" |

---

## When NOT to Use This Skill

| Operation | Use Instead |
|-----------|-------------|
| Search for pages | `confluence-search` |
| Add comments to pages | `confluence-comment` |
| Upload attachments | `confluence-attachment` |
| Add/remove labels | `confluence-label` |
| Set page restrictions | `confluence-permission` |
| View page analytics | `confluence-analytics` |
| Watch/unwatch pages | `confluence-watch` |
| Navigate page hierarchy | `confluence-hierarchy` |

---

## Risk Levels

| Operation | Risk | Notes |
|-----------|------|-------|
| Get page | - | Read-only |
| Create page | - | Easily deletable |
| Update page | ⚠️ | Creates version history, reversible |
| Copy page | - | Creates new page |
| Move page | ⚠️ | Can be moved back |
| Delete page | ⚠️⚠️ | Goes to trash, recoverable for 30 days |
| Permanent delete | ⚠️⚠️⚠️ | **IRREVERSIBLE** |

---

## Overview

This skill handles all CRUD operations for Confluence pages and blog posts, including:
- Creating new pages and blog posts
- Reading page content and metadata
- Updating page content, title, and status
- Deleting pages (trash or permanent)
- Copying and moving pages
- Version history and restoration

## CLI Commands

**Output format tip:** A global `-o/--output` flag placed before the subcommand (e.g. `confluence-as -o json page get 12345`) sets the default output format for all subcommands; an explicit subcommand-level `--output` wins.

### confluence-as page create

Create a new Confluence page.

**Usage:**
```bash
# Create a simple page
confluence-as page create --space DOCS --title "My New Page" --body "Page content here"

# Create with parent page
confluence-as page create --space DOCS --title "Child Page" --parent 12345 --body "Content"

# Create from Markdown file
confluence-as page create --space DOCS --title "From Markdown" --file content.md

# Create as draft
confluence-as page create --space DOCS --title "Draft Page" --body "WIP" --status draft
```

**Arguments:**
- `--space, -s` - Space key (required)
- `--title, -t` - Page title (required)
- `--body, -b` - Page body content as storage-format XHTML (or plain text). Markdown passed via `--body` is NOT converted and renders as literal text; use `--file` with a `.md` file for Markdown.
- `--file, -f` - Read body from file (files with a `.md`/`.markdown` extension are converted from Markdown)
- `--parent, -p` - Parent page ID
- `--status` - Page status: current (default) or draft
- `--output, -o` - Output format: text or json

### confluence-as page get

Retrieve a page's content and metadata.

**Usage:**
```bash
# Get by page ID
confluence-as page get 12345

# Get with full body content
confluence-as page get 12345 --body

# Get specific body format
confluence-as page get 12345 --body --format markdown

# JSON output
confluence-as page get 12345 --output json
```

**Arguments:**

From ulises-jeremias/agent-toolkit, MIT.

More from ulises-jeremias/agent-toolkit