confluence-assistant

Files (7)

• SKILL.md
• config.example.json · references/shared/config/
• config.schema.json · references/shared/config/
• DECISION_TREE.md · references/shared/docs/
• ERROR_HANDLING.md · references/shared/docs/
• QUICK_REFERENCE.md · references/shared/docs/
• SAFEGUARDS.md · references/shared/docs/

SKILL.md (first lines)

# Confluence Assistant

The central hub skill that routes Confluence requests to specialized skills.

## When to Use This Skill

Use this skill when you need to work with Confluence and are unsure which specific skill to use. This hub will intelligently route your request to the appropriate specialized skill based on keywords in your request.

**Note**: Trigger keywords are case-insensitive.

---

## Quick Reference

| Operation | Primary Skill | Risk Level |
|-----------|---------------|------------|
| Get/list pages | confluence-page | - |
| Create page | confluence-page | - |
| Update page | confluence-page | :warning: |
| Delete page | confluence-page | :warning::warning: |
| Copy/move page | confluence-page | :warning: |
| List spaces | confluence-space | - |
| Create space | confluence-space | - |
| Delete space | confluence-space | :warning::warning::warning: |
| Search content | confluence-search | - |
| Export search results | confluence-search | - |
| Add comment | confluence-comment | - |
| Delete comment | confluence-comment | :warning: |
| Upload attachment | confluence-attachment | - |
| Delete attachment | confluence-attachment | :warning::warning: |
| Add label | confluence-label | - |
| Remove label | confluence-label | - |
| Set permission | confluence-permission | :warning::warning: |
| Remove permission | confluence-permission | :warning::warning: |
| View analytics | confluence-analytics | - |
| Bulk label/move/delete | confluence-bulk | :warning::warning: |
| Cache management | confluence-ops | - |
| Admin operations | confluence-admin | :warning::warning: |

**Risk Levels**: - (safe) | :warning: (reversible) | :warning::warning: (destructive) | :warning::warning::warning: (irreversible)

---

## Explicit Routing Rules

### Rule 1: Explicit Skill Mention Wins
If the user explicitly names a skill, route directly to it.
- "Use confluence-search to find pages" → `confluence-search`
- "I need confluence-page skill" → `confluence-page`

### Rule 2: Entity Signals
Presence of identifiers suggests specific skills:
- **Page ID** (numeric) → likely `confluence-page`, `confluence-comment`, `confluence-attachment`
- **Space key** (uppercase) → likely `confluence-space`, `confluence-search`
- **CQL query** → `confluence-search`

### Rule 3: Operation Keywords
Match verbs to skill domains:
- Create/update/delete/copy/move page → `confluence-page`
- Search/find/query/export → `confluence-search`
- Comment/reply/resolve → `confluence-comment`
- Upload/download/attach → `confluence-attachment`

### Rule 4: Quantity Signals
Large-scale operations require bulk handling:
- Operations on 10+ items → `confluence-bulk`
- Bulk label operations → `confluence-bulk`
- Bulk delete/move → `confluence-bulk`
- "all pages in space" → `confluence-bulk`

### Rule 5: Ambiguous Requests
When intent is unclear, ask for clarification rather than guessing.

---

## Negative Triggers (What Each Skill Does NOT Handle)

| Skill | Does NOT Handle |
|-------|-----------------|
| `confluence-page` | Space-level operations, search queries, permissions, comments |
| `confluence-space` | Individual page content, page CRUD, comments, attachments |
| `confluence-search` | Content creation, content modification, permission changes |
| `confluence-comment` | Page content updates, attachments, labels |
| `confluence-attachment` | Page content, comments, permissions |
| `confluence-label` | Page content, search queries, permissions |
| `confluence-template` | Direct page CRUD, search, permissions |
| `confluence-property` | Page content (body), comments, permissions |
| `confluence-permission` | Page content, search, comments |
| `confluence-analytics` | Content modification (read-only skill) |
| `confluence-watch` | Content modification, permissions |
| `confluence-hierarchy` | Page content, permissions, search |
| `confluence-jira` | Pure Confluence operations (cross-product only) |
| `confluence-bulk` | Single-item operations, read-only queries |
| `confluence-ops` | Content operations, permissions, search |
| `confluence-admin` | Page content CRUD, search queries |

---

## Context Awareness

### Pronoun Resolution
When users say "it", "this", "that", refer to the most recently mentioned resource:
- "Get page 12345" → "Update it" = Update page 12345
- "Search in DOCS space" → "Export those results" = Export DOCS search

### Space Scope
Operations default to the current space context when established:
- "List pages in DOCS" → subsequent "create a page" assumes DOCS space

### Context Expiration
Context clears when:
- User explicitly changes topic
- New space or page is explicitly mentioned
- Session restarts

---

## Disambiguation Examples

From ulises-jeremias/agent-toolkit, MIT.

More from ulises-jeremias/agent-toolkit