Expert in Confluence operations using Atlassian MCP. Use when the user says "search Confluence", "create a Confluence page", "update a page", "find documentation in Confluence", "list spaces", or "add a comment to a page". Do NOT use for Jira issues, general web search, or local file creation.
70
62%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./packages/skills-catalog/skills/(development)/confluence-assistant/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description with excellent trigger terms and completeness. The explicit 'Use when' and 'Do NOT use' clauses make it very effective for skill selection. The main weakness is that the 'what' portion could be more specific—listing concrete capabilities as standalone statements rather than embedding them only within trigger phrases.
Suggestions
Strengthen the capability statement by listing concrete actions upfront, e.g., 'Searches Confluence content, creates and updates pages, lists spaces, and adds comments using Atlassian MCP' instead of the vague 'Expert in Confluence operations'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (Confluence operations via Atlassian MCP) and implies actions like searching, creating pages, updating pages, listing spaces, and adding comments, but these are embedded in the trigger clause rather than stated as explicit capability descriptions. It says 'Expert in Confluence operations' which is somewhat vague as a capability statement. | 2 / 3 |
Completeness | Clearly answers both 'what' (Confluence operations using Atlassian MCP) and 'when' (explicit 'Use when' clause with multiple trigger phrases). Also includes a 'Do NOT use' clause which adds further clarity on boundaries. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'search Confluence', 'create a Confluence page', 'update a page', 'find documentation in Confluence', 'list spaces', 'add a comment to a page'. These are phrases users would naturally say. The negative triggers (Jira, web search, local files) also help with routing. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche (Confluence via Atlassian MCP). The explicit exclusions for Jira, web search, and local file creation actively reduce conflict risk with adjacent skills. The trigger terms are all Confluence-specific. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides a reasonable overview of Confluence MCP operations with useful examples and a logical workflow structure. However, it suffers from significant redundancy (key points repeated 3+ times), unnecessary content Claude already knows (generic Markdown formatting, what Confluence is), and lacks validation/error-handling steps in its workflows. Trimming the repetition and adding explicit error recovery would substantially improve it.
Suggestions
Remove the duplicated guidance: 'Important Notes' section repeats 'Best Practices' almost verbatim, and 'Markdown is mandatory' appears at least 3 times. Consolidate into a single section.
Remove the 'Output Format' section showing generic Markdown structure—Claude already knows how to write well-structured Markdown.
Add explicit validation and error recovery steps to workflows, e.g., 'If search returns no results, try broader terms or list spaces directly' and 'Verify page exists before updating'.
Remove the 'When to Use' section since it duplicates the frontmatter description, and remove the 'You are an expert' preamble which wastes tokens on identity framing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Significant redundancy throughout: the 'Important Notes' section at the bottom repeats nearly verbatim the 'Best Practices' section. 'Markdown is mandatory', 'search first', 'validate IDs', and ID confusion warnings appear 3+ times each. The 'Output Format' section showing generic Markdown structure is unnecessary—Claude knows how to write Markdown. The opening 'You are an expert' and 'When to Use' sections restate the frontmatter description. | 1 / 3 |
Actionability | Provides concrete function signatures and examples with parameters, which is helpful. However, the function calls use placeholder-style syntax rather than being truly executable code in any language, and key details are missing—e.g., how to extract spaceId or pageId from search results, what the actual return types look like, and how to handle pagination or errors. | 2 / 3 |
Workflow Clarity | The numbered workflow (search → get details → create/update) is clear and well-sequenced. However, there are no validation checkpoints or error recovery steps. For example, the update workflow doesn't mention verifying the page was found before updating, and there's no guidance on what to do if search returns no results or if creation fails. The 'validate space exists' advice is mentioned but never shown as an explicit step in the workflow. | 2 / 3 |
Progressive Disclosure | Content is reasonably structured with clear sections and headings, but it's monolithic—everything is in one file with no references to external resources. The examples section, output format section, and configuration details could be split out. The content is long enough (~130 lines) that some progressive disclosure would help, but it's not egregiously long either. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
81e7e0d
Table of Contents
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.