confluence
Search and manage Confluence pages and spaces using CQL, read/create/update pages with Markdown support. Use when working with Confluence documentation.
87
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillEvaluation — 85%
↑ 2.12xAgent success when using this skill
Validation for skill structure
Discovery
85%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 well-crafted skill description that clearly identifies the Confluence-specific domain with concrete actions and an explicit 'Use when' clause. The main weakness is limited trigger term coverage - users might search for 'wiki' or 'knowledge base' content without mentioning 'Confluence' by name.
Suggestions
Add common synonyms users might use: 'wiki', 'knowledge base', 'Atlassian docs', or 'team documentation'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'Search and manage', 'read/create/update pages' with specific features like 'CQL' and 'Markdown support'. These are specific, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers 'what' (search, manage, read/create/update Confluence pages with CQL and Markdown) and 'when' with explicit trigger: 'Use when working with Confluence documentation.' | 3 / 3 |
Trigger Term Quality | Includes 'Confluence', 'pages', 'spaces', 'CQL', and 'documentation' but misses common variations users might say like 'wiki', 'knowledge base', 'Atlassian', or 'company docs'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Confluence' is a specific product name that creates a clear niche. The mention of 'CQL' (Confluence Query Language) and 'spaces' further distinguishes this from generic documentation skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured CLI tool skill with excellent actionability and progressive disclosure. Commands are concrete and executable with clear examples. The main weakness is some verbosity in authentication setup and troubleshooting sections that could be tightened, as Claude doesn't need extensive explanation of common issues like 'permission denied' or 'import errors'.
Suggestions
Condense the authentication section by removing explanatory text and showing only the configuration examples with minimal inline comments
Trim the troubleshooting section to just the non-obvious issues (CQL syntax, Cloud vs DC differences) since Claude can infer solutions for basic problems like 'permission denied' or missing pip packages
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some unnecessary explanations (e.g., explaining what CQL is, detailed troubleshooting for basic issues). The authentication section could be more compact, and some examples are repetitive. | 2 / 3 |
Actionability | Provides fully executable commands with concrete examples throughout. All CLI commands are copy-paste ready with clear argument documentation and example outputs showing expected results. | 3 / 3 |
Workflow Clarity | Clear setup verification workflow with the 'check' command that validates dependencies, auth, and connectivity. For a CLI tool skill, the single-command operations are unambiguous, and the check command provides explicit validation before use. | 3 / 3 |
Progressive Disclosure | Excellent structure with clear overview, well-organized sections, and appropriate references to external files (creating-content.md) for advanced operations. Navigation is easy with a CQL reference table and logical command groupings. | 3 / 3 |
Total | 11 / 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.
- 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.