confluence-watch

Files (2)

• SKILL.md
• api-reference.md · references/

SKILL.md (first lines)

# Confluence Watch Skill

Manage content watching and notifications in Confluence.

---

## ⚠️ PRIMARY USE CASE

**This skill manages watch/follow subscriptions.** Use for:
- Watching pages for updates
- Watching spaces for new content
- Unwatching content
- Checking who is watching

---

## When to Use / When NOT to Use

| Use This Skill | Use Instead |
|----------------|-------------|
| Watch/unwatch pages | - |
| Watch/unwatch spaces | - |
| List watchers | - |
| View analytics | `confluence-analytics` |
| Set permissions | `confluence-permission` |

---

## Risk Levels

| Operation | Risk | Notes |
|-----------|------|-------|
| List watchers | - | Read-only |
| Watch content | - | Can be unwatched |
| Unwatch content | - | Can re-watch |

---

## Overview

This skill provides comprehensive watching and notification management:
- Watch/unwatch individual pages
- Watch entire spaces for new content
- Check who is watching content
- Verify your own watch status

## CLI Commands

### confluence-as watch page
Start watching a Confluence page to receive notifications for updates.

**Usage:**
```bash
confluence-as watch page PAGE_ID [--output FORMAT]
```

**Arguments:**
- `PAGE_ID` - ID of the page to watch (required)
- `--output, -o` - Output format: text or json (default: text)

**Examples:**
```bash
# Watch a page
confluence-as watch page 123456

# Get JSON output
confluence-as watch page 123456 --output json
```

### confluence-as watch unwatch-page
Stop watching a Confluence page.

**Usage:**
```bash
confluence-as watch unwatch-page PAGE_ID [--output FORMAT]
```

**Arguments:**
- `PAGE_ID` - ID of the page to unwatch (required)
- `--output, -o` - Output format: text or json (default: text)

**Examples:**
```bash
# Unwatch a page
confluence-as watch unwatch-page 123456

# Unwatch with JSON output
confluence-as watch unwatch-page 123456 --output json
```

### confluence-as watch space
Start or stop watching an entire Confluence space to receive notifications for new content.

**Usage:**
```bash
confluence-as watch space SPACE_KEY [--unwatch] [--output FORMAT]
```

**Arguments:**
- `SPACE_KEY` - Key of the space to watch/unwatch (required)
- `--unwatch, -u` - Unwatch the space instead of watching it
- `--output, -o` - Output format: text or json (default: text)

**Examples:**
```bash
# Watch a space
confluence-as watch space DOCS

# Watch space with lowercase key (auto-converted to uppercase)
confluence-as watch space kb

# Unwatch a space
confluence-as watch space DOCS --unwatch

# Unwatch using short flag
confluence-as watch space TEST -u

# Get JSON output
confluence-as watch space TEST --output json

From ulises-jeremias/agent-toolkit, MIT.

More from ulises-jeremias/agent-toolkit