Guide · Agent skill
How to use the Confluence Wiki Expert agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Confluence Wiki Expert skill is a set of written guidance that makes an AI agent answer questions the way an experienced Confluence documentation specialist would. This guide explains what the skill covers, how to install it, how to trigger it with everyday requests, and what it does and does not do. By the end you will know how to ask the agent for help planning a space, designing page trees and labels, or drafting REST API calls.
Confluence Wiki ExpertRightNow-AI/openfang · Apache-2.0 Download the skill Quick start
- 1Download the ZIP. Download the confluence skill ZIP from this page.
- 2Unzip the folder. Unzip the file so that SKILL.md sits in a confluence folder.
- 3Place it in a skills folder. Move the folder into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder.
- 4Or upload it in the Claude apps. Go to Settings, then Capabilities, then Skills, and upload the skill.
- 5Ask a Confluence question. Describe your goal in plain language, such as planning a space or restructuring a page tree.
- 6Review the output. Check recommendations against your real space, permissions and content before acting on them.
What the Confluence skill makes the agent do
An agent skill is a folder containing a SKILL.md file with instructions the agent reads when a request matches the skill's description. This one is aimed at knowledge bases, team wikis and project documentation in Confluence.
Once loaded, the agent gives advice on structuring spaces around teams or projects, keeping page hierarchies no more than three to four levels deep, applying labels consistently, and choosing macros such as Children Display, Content by Label, Page Properties and Page Properties Report, Table of Contents and Excerpt Include. It also covers page templates for recurring documents such as meeting notes, ADRs and postmortems, and setting permissions so sensitive pages such as HR or security content are restricted.
- Space planning and navigation design
- Page hierarchy and label taxonomy guidance
- Macro choices for reports, indexes and reusable content
- Patterns for decision logs, runbook registries, meeting-notes series and knowledge base landing pages
- Draft REST API calls: GET /rest/api/content for search, POST for creating pages and PUT for updates, using storage format XHTML
Install the skill from the ZIP
Download the ZIP file for the confluence skill from this page and unzip it. The folder contains SKILL.md, the only file in this skill.
For a personal setup, place the unzipped folder inside ~/.claude/skills/. To scope the skill to one project, place it inside that project's .claude/skills/ folder instead.
You can also upload the skill in the Claude apps. Go to Settings, then Capabilities, then Skills, and upload it there.
- Personal install: ~/.claude/skills/ (available across your projects)
- Project install: .claude/skills/ inside the project folder
- Claude apps: Settings → Capabilities → Skills
Trigger the skill with natural requests
You do not need a special command. Ask in plain language about Confluence structure, macros, labels, permissions or the REST API, and the agent will use the skill when your request matches its description.
Be specific about your goal, the team or content type, and the output you want. Mentioning the macro or the document type (for example, runbooks or meeting notes) helps the agent pick the right pattern.
- "Plan a Confluence space for our platform team with a clear owner and scope."
- "Design a decision log in Confluence using ADRs and a Page Properties Report."
- "Restructure our flat Confluence space so the page tree is no more than four levels deep."
- "Write a REST API call that creates a runbook page in storage format."
Example workflow: a runbook registry
Suppose your engineering team wants a registry of runbooks. Ask the agent to outline the design. Based on the skill's common patterns, it will suggest a Page Properties macro on each runbook page with fields such as service, severity and last-reviewed date, plus a Report macro on an index page to aggregate them.
You then take that plan into Confluence and build it yourself, or ask the agent to draft the storage format for the page body. Check every draft against your own space before publishing.
What the skill needs and what it does not do
The skill lists no requirements, runs no scripts and uses no network access. It contains guidance only. It does not connect to your Confluence site, and no credentials are supplied in the files. The agent cannot read or edit your wiki through this skill alone.
The skill advises on permissions but does not check them. Confirm access settings on sensitive spaces and pages yourself.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
- Connection to Confluence: not provided by the skill
Tips for getting useful results
Give the agent your current structure, such as the space names and the number of levels, so its advice fits your real site rather than a generic one.
Ask for the reasoning behind a recommendation. The skill emphasises discoverability, maintainability and a single source of truth, so the explanations help you decide what to keep.
Review any REST API request before running it against a live site, and test on a non-production space first.
- Describe your current space and page tree before asking for changes
- Ask why a pattern is recommended to judge fit
- Avoid duplicating content; the skill suggests Excerpt Include or page links instead
- Test API calls in a sandbox space first
What people use it for
- Planning a new team or project space with a clear owner and scope
- Restructuring a deep or flat page tree into a shallower hierarchy
- Designing a decision log with an ADR template and a Page Properties Report
- Building a runbook registry with Page Properties fields on each page
- Drafting REST API calls to search, create or update pages in storage format
Frequently asked questions
How do I install the Confluence agent skill?
Download the ZIP from this page and unzip it. Place the folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder, or upload it in the Claude apps under Settings, Capabilities, then Skills.
Does the Confluence skill connect to my Confluence site?
No. The skill contains written guidance only. The files provide no connection or credentials, so the agent cannot read or edit your wiki through this skill alone.
What does the Confluence skill require?
The skill lists no requirements. It runs no scripts and uses no network access, according to its listing.
Is the Confluence agent skill free?
The source material does not state pricing or licence terms beyond the listed licence, Apache-2.0. Check the repository for the licence text before reusing it.
Can the agent create Confluence pages for me?
The skill can write REST API calls such as POST for creation and PUT for updates in storage format XHTML. You still need to run those calls yourself with your own access, since the skill does not supply credentials.
How does this compare to just asking a general AI for Confluence advice?
This skill focuses on specific conventions such as three to four levels of page depth, label taxonomies, named macros and permission restrictions. A general request may give broader advice, so the skill helps keep answers consistent with these patterns.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are a team lead, wiki admin or engineer planning or restructuring Confluence spaces, or a developer drafting REST API page calls and want advice in a consistent Confluence-specialist style. Pick something else if you need an agent that actually reads or edits your Confluence site, or if you need the tool to enforce and verify page permissions, since this skill only gives guidance.
Download the skill