# Confluence Label

> Manage content labels - add, remove, and search by labels. ALWAYS use when user wants to tag, label, or categorize content.

- Skill: `grandcamel/confluence-label` (Agent Skill)
- Install (CLI): `npx skillmds@latest add grandcamel/confluence-label`
- Raw SKILL.md: https://api.skillmd.com/api/skills/grandcamel/confluence-label/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: grandcamel (https://skillmd.com/u/grandcamel)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/grandcamel/confluence-label

---


# Confluence Label Skill

Manage labels on Confluence content.

---

## ⚠️ PRIMARY USE CASE

**This skill manages labels (tags) on Confluence content.** Use for:
- Adding labels to pages
- Removing labels
- Finding content by label
- Viewing popular labels

---

## When to Use / When NOT to Use

| Use This Skill | Use Instead |
|----------------|-------------|
| Add/remove labels | - |
| Find by label | `confluence-search` (for complex queries) |
| List page labels | - |
| Create/edit pages | `confluence-page` |
| Set permissions | `confluence-permission` |

---

## Risk Levels

All operations are **low risk** and easily reversible:

| Operation | Risk | Notes |
|-----------|------|-------|
| List labels | - | Read-only |
| Add label | - | Can be removed |
| Remove label | - | Can be re-added |
| Search by label | - | Read-only |

---

## CLI Commands

### confluence-as label add
Add one or more labels to content.

**Usage:**
```bash
confluence-as label add PAGE_ID LABEL [LABEL ...]
confluence-as label add 12345 documentation --output json
```

**Options:**
- `--output, -o` - Output format: text or json

**Examples:**
```bash
confluence-as label add 12345 documentation
confluence-as label add 12345 doc approved v2
```

### confluence-as label remove
Remove a label from content.

**Usage:**
```bash
confluence-as label remove PAGE_ID LABEL
confluence-as label remove 12345 draft --output json
```

**Options:**
- `--output, -o` - Output format: text or json

**Examples:**
```bash
confluence-as label remove 12345 draft
```

### confluence-as label list
List labels on content.

**Usage:**
```bash
confluence-as label list 12345
confluence-as label list 12345 --output json
```

**Options:**
- `--output, -o` - Output format: text or json

### confluence-as label search
Find content by label.

**Usage:**
```bash
confluence-as label search documentation
confluence-as label search approved --space DOCS
confluence-as label search api-docs --type page --limit 50
```

**Options:**
- `--space, -s` - Limit to specific space
- `--type` - Content type filter: page or blogpost
- `--limit, -l` - Maximum results (default: 25)
- `--output, -o` - Output format: text or json

### confluence-as label popular
List most used labels.

**Usage:**
```bash
confluence-as label popular --space DOCS
confluence-as label popular --limit 20
confluence-as label popular --output json
```

**Options:**
- `--space, -s` - Limit to specific space
- `--limit, -l` - Maximum labels to return (default: 25)
- `--output, -o` - Output format: text or json