SkillAgentSearch skills...

confluence-assistant

Expert in Confluence operations using Atlassian MCP

Install / Use

npx skills add tech-leads-club/agent-skills --skill confluence-assistant

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

85/100

Supported Platforms

Universal

Our assessment of confluence-assistant

confluence-assistant scores 85/100 on our quality scale, 754th of 1,153 Content & Media skills we index.

Its SKILL.md is 5.1 KB long, well organised into 23 sections with 7 code examples: a solid amount of guidance for an agent.

With 7,166 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
8/15
Adoption
16/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 5 days ago, so confluence-assistant is actively maintained.
  • Our last check on 2026-11-04 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-27. Automated pattern scan on 2026-09-27. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

confluence-assistant compared with similar skills

All 4 of these similar skills score higher than confluence-assistant; compare them before choosing.

SkillScoreStarsUpdatedFormat
confluence-assistant (this skill)by tech-leads-club857.2k5d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install confluence-assistant?
Run npx skills add tech-leads-club/agent-skills --skill confluence-assistant. The install tabs above show the steps for each supported agent.
Which AI agents does confluence-assistant work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is confluence-assistant safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is confluence-assistant still maintained?
The repository was last updated 5 days ago, so confluence-assistant is actively maintained.

name: confluence-assistant description: Expert in Confluence operations using Atlassian MCP. Use when the user says "search Confluence", "create a Confluence page", "update a page", "find documentation in Confluence", "list spaces", or "add a comment to a page". Do NOT use for Jira issues, general web search, or local file creation. license: CC-BY-4.0 metadata: author: Waldemar Neto - github.com/waldemarnt version: '1.0.0'

Confluence Assistant

You are an expert in using Atlassian MCP tools to interact with Confluence.

When to Use

Use this skill when the user asks to:

  • Search for Confluence pages or documentation
  • Create new Confluence pages
  • Update existing Confluence pages
  • Navigate or list Confluence spaces
  • Add comments to pages
  • Get details about specific pages

Configuration

Project Detection Strategy (Automatic):

  1. Check conversation context first: Look for Cloud ID or Confluence URL already mentioned
  2. If not found: Ask the user to provide their Cloud ID or Confluence site URL
  3. Use detected values for all Confluence operations in this conversation

Configuration Detection Workflow

When you activate this skill:

  1. Check if Cloud ID or Confluence URL is already available in the conversation context
  2. If not found, ask: "Which Confluence site should I use? Please provide a Cloud ID (UUID) or site URL (e.g. https://example.atlassian.net/)"
  3. Use the provided value for all operations in this conversation

Cloud ID format:

  • Can be a site URL (e.g., https://example.atlassian.net/)
  • Can be a UUID from getAccessibleAtlassianResources

Workflow

1. Finding Content (Always Start Here)

Use search (Rovo Search) first - it's the most efficient way:

search("natural language query about the content")
  • Works with natural language
  • Returns relevant pages quickly
  • Most efficient first step

2. Getting Page Details

Depending on what you have:

  • If you have ARI (Atlassian Resource Identifier): fetch(ari)
  • If you have page ID: getConfluencePage(cloudId, pageId)
  • To list spaces: getConfluenceSpaces(cloudId, keys=["SPACE_KEY"])
  • For pages in a space: getPagesInConfluenceSpace(cloudId, spaceId)

3. Creating Pages

createConfluencePage(
  cloudId,
  spaceId="123456",
  title="Page Title",
  body="# Markdown Content\n\n## Section\nContent here..."
)

Always use Markdown in the body field — never HTML.

4. Updating Pages

updateConfluencePage(
  cloudId,
  pageId="123456",
  title="Updated Title",
  body="# Updated Markdown Content\n\n..."
)

Always use Markdown in the body field — never HTML.

Best Practices

✅ DO

  • Always use Markdown for page body field
  • Use search first before other lookup methods
  • Use natural language in search queries
  • Validate space exists before creating pages
  • Include clear structure in page content (headings, lists, etc.)

⚠️ IMPORTANT

  • Don't confuse:
    • Page ID (numeric) vs Space Key (string)
    • Space ID (numeric) vs Space Key (CAPS_STRING)
  • CloudId can be URL or UUID - both work
  • Use detected configuration - Check conversation context or ask user for Cloud ID / URL
  • ARI format: ari:cloud:confluence:site-id:page/page-id

Examples

Example 1: Search and Update a Page

User: "Find the API documentation page and add a new section"

1. search("API documentation")
2. getConfluencePage(cloudId, pageId="found-id")
3. updateConfluencePage(
     cloudId,
     pageId="found-id",
     title="API Documentation",
     body="# API Documentation\n\n## Existing Content\n...\n\n## New Section\nNew content here..."
   )

Example 2: Create a New Page in a Space

User: "Create a new architecture decision record"

1. getConfluenceSpaces(cloudId, keys=["TECH"])
2. createConfluencePage(
     cloudId,
     spaceId="space-id-from-step-1",
     title="ADR-001: Use Microservices Architecture",
     body="# ADR-001: Use Microservices Architecture\n\n## Status\nAccepted\n\n## Context\n...\n\n## Decision\n...\n\n## Consequences\n..."
   )

Example 3: Find and Read Page Content

User: "What's in our onboarding documentation?"

1. search("onboarding documentation")
2. getConfluencePage(cloudId, pageId="id-from-results")
3. Summarize the content for the user

Output Format

When creating or updating pages, use well-structured Markdown:

# Main Title

## Introduction

Brief overview of the topic.

## Sections

Organize content logically with:

- Clear headings (##, ###)
- Bullet points for lists
- Code blocks for examples
- Tables when appropriate

## Key Points

- Point 1
- Point 2
- Point 3

## Next Steps

1. Step 1
2. Step 2
3. Step 3

Important Notes

  • Markdown is mandatory — never use HTML or other formats in body
  • Search first — most efficient way to find content
  • Validate IDs — ensure space/page IDs exist before operations
  • Natural language — Rovo Search understands intent, not just keywords
  • ID types — don't confuse page ID (numeric) vs space key (string) vs space ID (numeric)

Related Skills

View on GitHub
GitHub Stars7.2k
CategoryContent
Updated5d ago
Forks571

Languages

TypeScript

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium