Name: confluence-expert
Rating: 64 (1 reviews)
Author: alirezarezvani

confluence-expert

Atlassian Confluence expert for creating and managing spaces, knowledge bases, and documentation. Configures space permissions and hierarchies, creates page templates with macros, sets up documentation taxonomies, designs page layouts, and manages content governance. Use when users need to build or restructure a Confluence space, design page hierarchies with permission structures, author or standardise documentation templates, embed Jira reports in pages, run knowledge base audits, or establish documentation standards and collaborative workflows.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/confluence-expert/SKILL.md

The canonical home for this skill is confluence-expert in alirezarezvani/claude-skills

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is rich in concrete, executable Confluence guidance with well-sequenced, validated workflows. Its main weaknesses are length/generic padding and a broken progressive-disclosure layer where every referenced bundle file is absent.

Suggestions

Trim the generic Handoff Protocols, Best Practices, and Analytics & Metrics sections (largely role-coordination and list content) or move them to a reference to improve token efficiency.

Show actual storage-format XHTML for inline macro examples instead of legacy {macro} notation that requires a corrective syntax note, or drop the inline examples and rely solely on the macro cheat-sheet reference.

Ship the referenced bundle files (references/macro-cheat-sheet.md, references/templates.md, references/space-architecture-patterns.md, references/atlassian-mcp-tools.md, scripts/space_structure_generator.py, scripts/content_audit_analyzer.py) — currently none exist, so the well-signaled references and the script-dependent workflow steps are non-functional.

Dimension	Reasoning	Score
Conciseness	The bulk is high-value Confluence-specific content (MCP tool calls, CQL, storage-format gotchas), but it is noticeably long with repetition ("not available via MCP" stated in both the integration and Space Creation sections) and generic list sections (Handoff Protocols, Best Practices, Analytics & Metrics). Not 4: the padded role-coordination and generic best-practice lists go beyond minor trimming.	3 / 5
Actionability	Concrete, copy-pasteable guidance throughout — real MCP tool names with parameters, CQL examples, and bash commands. Not 5: the referenced scripts (space_structure_generator.py, content_audit_analyzer.py) do not exist in the bundle, and inline macro examples use legacy {macro} notation shown "for readability only" rather than the required storage format.	4 / 5
Workflow Clarity	Workflows (Space Creation, Template Creation, KB Management) are clearly numbered with explicit "Verify" checkpoints and a content-health-audit gate before restructure. Not 5: the Documentation Strategy workflow lacks an explicit validation step and the archiving flow is described rather than sequenced with checkpoints.	4 / 5
Progressive Disclosure	References are well-signaled and one-level-deep via dedicated callouts ("See also", "see references/..."), with inline summaries. Not 4: none of the referenced files exist in the bundle — references/, scripts/, and assets/ are absent — so the clearly-signaled navigation leads to missing files, making the disclosure non-functional.	3 / 5
	Total	14 / 20 Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that clearly states capabilities and provides an explicit, multi-trigger "Use when" clause. Minor overlap with sibling Atlassian skills and a few missing synonyms keep it just short of perfect.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions — "creating and managing spaces, knowledge bases, and documentation", "Configures space permissions and hierarchies", "creates page templates with macros", "sets up documentation taxonomies", "designs page layouts", "manages content governance" — giving comprehensive coverage. Not 4: the action list is broad and concrete rather than having only minor gaps.	5 / 5
Completeness	Explicitly answers both what (the capability list) and when (a concrete "Use when users need to..." clause with multiple trigger phrases). Not 4: the when-clause is explicit and specific, matching the anchor that requires concrete trigger phrases.	5 / 5
Trigger Term Quality	The "Use when" clause supplies natural phrases users would say — "build or restructure a Confluence space", "design page hierarchies with permission structures", "author or standardise documentation templates", "embed Jira reports in pages", "run knowledge base audits". Not 5: common synonyms/variants like "wiki", "Confluence pages", or "blueprints" are absent.	4 / 5
Distinctiveness Conflict Risk	Confluence space/page/template management is a clear niche with distinct triggers. Not 5: the "embed Jira reports" and template triggers create minor overlap with the related jira-expert and atlassian-templates skills named in the body.	4 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 8 missing	Warning

	Total	15 / 16 Passed

Repository: alirezarezvani/claude-skills
Path: .gemini/skills/confluence-expert/SKILL.md
Commit: 19392f7

Reviewed: ~3 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.