How do I install the Confluence Docs skill?

Run npx skillmds@latest add incidentfox/confluence-docs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Confluence Docs safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Confluence Docs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Confluence Docs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Confluence Docs?

incidentfox (@incidentfox) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Confluence Docs by incidentfox — Agent Skill

Name: Confluence Docs
Author: incidentfox

File contents

Confluence Documentation

Authentication

Set these environment variables:

CONFLUENCE_URL — Your Confluence instance URL (e.g., https://yourcompany.atlassian.net)
CONFLUENCE_EMAIL — Your Atlassian account email
CONFLUENCE_API_TOKEN — API token from https://id.atlassian.com/manage-profile/security/api-tokens

Available Scripts

All scripts are in .claude/skills/confluence-docs/scripts/

search_pages.py - Search Pages

python .claude/skills/confluence-docs/scripts/search_pages.py --query SEARCH_QUERY [--space SPACE_KEY] [--limit N]

# Examples:
python .claude/skills/confluence-docs/scripts/search_pages.py --query "refund policy"
python .claude/skills/confluence-docs/scripts/search_pages.py --query "onboarding" --space HR
python .claude/skills/confluence-docs/scripts/search_pages.py --query "deployment process" --limit 20

Client Library Functions

The confluence_client.py module provides:

Function	Purpose
`search_content(cql, limit)`	Search pages using CQL
`get_page_by_id(page_id)`	Get page content by ID
`get_page_by_title(space, title)`	Get page by title + space

Common CQL Patterns

Pattern	Example	Purpose
Text search	`text ~ "deployment"`	Full text search
Space filter	`space = "ENG" AND type = page`	Pages in a space
Recent docs	`lastModified >= now("-30d")`	Recently updated
By label	`type = page AND label = "runbook"`	Pages with label
Combined	`space = "HR" AND text ~ "onboarding"`	Complex queries

Common Workflows

1. Find Documentation on a Topic

# Step 1: Search broadly
python search_pages.py --query "authentication"

# Step 2: Narrow to a space
python search_pages.py --query "authentication" --space ENG

2. Find Internal Processes

python search_pages.py --query "how to request access"

3. Research Before Answering

# Search for existing documentation
python search_pages.py --query "refund process"

# Get full page content using the client library
# (from Python code, not CLI — use get_page_by_id)

Quick Reference

Goal	Command
Search pages	`search_pages.py --query "topic"`
Filter by space	`search_pages.py --query "topic" --space ENG`

Best Practices

Start broad — Search without space filter first
Use spaces — Narrow with --space when you know the team
Check recency — Recent pages are more likely current
Read full page — Use get_page_by_id() from the client library when search snippets aren't enough

---name: confluence-docsdescription: Search and read Confluence documentation. Use when looking for internal docs, knowledge base articles, runbooks, or team documentation stored in Confluence.---# Confluence Documentation## AuthenticationSet these environment variables:- `CONFLUENCE_URL` — Your Confluence instance URL (e.g., `https://yourcompany.atlassian.net`)- `CONFLUENCE_EMAIL` — Your Atlassian account email- `CONFLUENCE_API_TOKEN` — API token from https://id.atlassian.com/manage-profile/security/api-tokens---## Available ScriptsAll scripts are in `.claude/skills/confluence-docs/scripts/`### search_pages.py - Search Pages```bashpython .claude/skills/confluence-docs/scripts/search_pages.py --query SEARCH_QUERY [--space SPACE_KEY] [--limit N]# Examples:python .claude/skills/confluence-docs/scripts/search_pages.py --query "refund policy"python .claude/skills/confluence-docs/scripts/search_pages.py --query "onboarding" --space HRpython .claude/skills/confluence-docs/scripts/search_pages.py --query "deployment process" --limit 20```---## Client Library FunctionsThe `confluence_client.py` module provides:| Function | Purpose ||----------|---------|| `search_content(cql, limit)` | Search pages using CQL || `get_page_by_id(page_id)` | Get page content by ID || `get_page_by_title(space, title)` | Get page by title + space |---## Common CQL Patterns| Pattern | Example | Purpose ||---------|---------|---------|| Text search | `text ~ "deployment"` | Full text search || Space filter | `space = "ENG" AND type = page` | Pages in a space || Recent docs | `lastModified >= now("-30d")` | Recently updated || By label | `type = page AND label = "runbook"` | Pages with label || Combined | `space = "HR" AND text ~ "onboarding"` | Complex queries |---## Common Workflows### 1. Find Documentation on a Topic```bash# Step 1: Search broadlypython search_pages.py --query "authentication"# Step 2: Narrow to a spacepython search_pages.py --query "authentication" --space ENG```### 2. Find Internal Processes```bashpython search_pages.py --query "how to request access"```### 3. Research Before Answering```bash# Search for existing documentationpython search_pages.py --query "refund process"# Get full page content using the client library# (from Python code, not CLI — use get_page_by_id)```---## Quick Reference| Goal | Command ||------|---------|| Search pages | `search_pages.py --query "topic"` || Filter by space | `search_pages.py --query "topic" --space ENG` |---## Best Practices- **Start broad** — Search without space filter first- **Use spaces** — Narrow with `--space` when you know the team- **Check recency** — Recent pages are more likely current- **Read full page** — Use `get_page_by_id()` from the client library when search snippets aren't enough

Frequently asked questions

Confluence Docs