# Confluence

> Confluence team documentation platform. Use for documentation.

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

---


# Confluence

Confluence is the wiki for Jira users. It excels at **structured documentation** and deep Jira integration (embedding live Jira tables).

## When to Use

- **Enterprise Docs**: HR policies, Engineering Standards.
- **Jira Reports**: Pages that pull in Jira data dynamically.
- **Whiteboards**: Visual collaboration capabilities (competing with Miro).

## Core Concepts

### Spaces

Containers for pages (e.g. "Engineering", "Marketing").

### Page Tree

Hierarchical organization of pages.

### Macros

Dynamic content (`{jira}`, `{code}`, `{toc}`).

## Best Practices (2025)

**Do**:

- **Use "Page Properties"**: Metadata for pages that can be queried in a "Page Properties Report".
- **Use Templates**: Standardize "Post Mortem" or "RFC" docs.
- **Comment Inline**: Highlight text to comment contextually.

**Don't**:

- **Don't let it rot**: Assign "Owners" to pages to ensure freshness.

## References

- [Confluence Documentation](https://support.atlassian.com/confluence-cloud/)