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 highly actionable for skill selection. The main weakness is that the 'what' portion could be more specific about concrete capabilities rather than relying on the generic 'Expert in Confluence operations' framing.
Suggestions
Replace 'Expert in Confluence operations using Atlassian MCP' with a more specific capability list, e.g., 'Searches Confluence content, creates and updates pages, lists spaces, and adds comments using Atlassian MCP.'
| 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 Confluence-specific triggers and explicit exclusions for Jira, general web search, and local file creation. This makes it very unlikely to conflict with other skills. | 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 covers Confluence operations comprehensively with a clear structure and useful examples, but suffers from significant redundancy—key points like 'use Markdown', 'search first', and ID confusion warnings are repeated 3+ times across sections. Actionability is moderate with good function signatures but placeholder-heavy examples lacking error handling. The workflow would benefit from explicit validation/verification steps after create and update operations.
Suggestions
Eliminate redundancy by removing the 'Important Notes' section entirely (it duplicates 'Best Practices') and consolidating repeated advice about Markdown and search-first into a single location.
Remove the 'Output Format' section showing generic Markdown structure—Claude already knows how to write Markdown; instead, note any Confluence-specific Markdown limitations or quirks.
Add explicit validation steps to workflows: after creating/updating a page, verify success by fetching the page and confirming changes; include error recovery guidance (e.g., what to do if a space ID is invalid).
Remove the 'When to Use' section as it duplicates the frontmatter description, and remove the 'You are an expert' opening line 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 page ID from search results, how to get the actual current body content before appending to it in an update. The examples show workflows but with gaps (e.g., 'found-id' placeholders without showing how to parse results). | 2 / 3 |
Workflow Clarity | The numbered workflow steps (search → get details → create/update) are clear and logically sequenced. However, there are no validation checkpoints or error recovery steps. For example, the update workflow doesn't mention verifying the update succeeded, and the create workflow says 'validate space exists' in best practices but doesn't include that as an explicit step with error handling in the workflow itself. | 2 / 3 |
Progressive Disclosure | Content is organized with clear sections and headings, which aids navigation. However, it's monolithic—all content is inline in one file with no references to external resources. The output format template and detailed examples could be split out. For a skill of this length (~130 lines of substantive content), some progressive disclosure to separate files would improve organization. | 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.
906a57d
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.