CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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

SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

A well-structured, actionable body with concrete MCP tool usage, honest capability boundaries ('Space creation is not available via MCP'), explicit verification steps, and clearly signaled references. The main weakness is token efficiency: the legacy wiki-markup macro and layout catalogs are non-executable for MCP-based page creation and duplicate content already deferred to references.

Suggestions

Cut the legacy wiki-markup macro examples ('{info}', '{expand}', '{section}', etc.) from the body and keep only a few representative entries with a pointer to references/macro-cheat-sheet.md — the body already states this notation is 'shown for readability only' and not usable for MCP page creation, so ~100 lines earn little value.

Add a validation or success-check step to the Documentation Strategy and Knowledge Base governance workflows (e.g., re-run content_audit_analyzer.py after archiving to confirm the stale/orphan list shrinks) to match the quality of the Space Creation workflow.

Flesh out or explicitly delegate the vague UI-only workflow steps ('Set space homepage with overview', 'Add space shortcuts for navigation') — either give the exact UI path/REST endpoint, as done for space creation and labels, or point to a reference.

DimensionReasoningScore

Conciseness

Mostly efficient bullet-style content, but roughly a quarter of the body (~100 lines) is legacy wiki-markup macro and layout examples that the body itself flags as 'shown for readability only' and not the storage format MCP creation requires — more than minor over-explanation that could be tightened by deferring entirely to the macro cheat sheet.

3 / 5

Actionability

Mostly executable guidance: concrete MCP tool signatures with parameters ('mcp__atlassian__updateConfluencePage (cloudId, pageId="789012", version=5, body=...)'), runnable CQL examples, and script invocations with explicit input/output consumption. Minor gaps: UI-only steps like 'Add space shortcuts for navigation' and 'Set space homepage' lack specifics, and the wiki-markup examples need translation via a reference.

4 / 5

Workflow Clarity

Space Creation and Template Creation have clear sequences with explicit **Verify** checkpoints ('check that a non-admin test user sees the correct permission level'; 'confirm all placeholders render correctly'), plus a handoff step. Not a 5: the Documentation Strategy workflow has no validation step and several steps ('Create initial page tree structure') are thin without the generator script context.

4 / 5

Progressive Disclosure

Good structure with well-signaled, one-level-deep references — each pointer describes what the file contains ('references/macro-cheat-sheet.md for storage-format macro syntax', 'references/space-architecture-patterns.md for space structure and permission patterns'). Not a 5: the inlined legacy macro catalog duplicates the macro cheat sheet, and permission scheme details are partially inlined despite the dedicated reference.

4 / 5

Total

15

/

20

Passed

Description

92%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 description: third-person voice, concrete capability list, and an explicit 'Use when...' clause with natural trigger phrases. Only gap is a few missing common synonyms ('wiki', 'Confluence page'), keeping trigger term quality at 4.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'Configures space permissions and hierarchies, creates page templates with macros, sets up documentation taxonomies, designs page layouts, and manages content governance' — covering the domain comprehensively, matching the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

It explicitly answers both: what ('creating and managing spaces, knowledge bases, and documentation... manages content governance') and when ('Use when users need to build or restructure a Confluence space, design page hierarchies... or establish documentation standards and collaborative workflows') with concrete trigger phrases — a clear match to the top anchor.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say ('build or restructure a Confluence space', 'embed Jira reports in pages', 'run knowledge base audits'), but a few natural synonyms are missing (e.g., 'wiki', 'Confluence page'). It does not reach the comprehensive synonym/extension coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct Confluence-specific triggers; the only cross-tool mention ('embed Jira reports in pages') is explicitly framed as embedding into Confluence pages, so conflict risk with a Jira skill is minimal.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/confluence-expert/SKILL.md

Reviewed

Table of Contents

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.