odyssey4me/confluence
Search and manage Confluence pages and spaces using CQL, read/create/update pages with Markdown support. Use when working with Confluence documentation.
83
Quality
83%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
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-structured skill description that clearly identifies the Confluence-specific domain and provides explicit 'Use when' guidance. The main weakness is limited trigger term coverage - users might describe their need using terms like 'wiki', 'knowledge base', or 'Atlassian' that aren't captured.
Suggestions
Expand trigger terms to include common user phrases like 'wiki', 'knowledge base', 'Atlassian', or 'team documentation'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Search and manage', 'read/create/update pages', with specific features like 'CQL' and 'Markdown support'. Uses proper third person voice. | 3 / 3 |
Completeness | Clearly answers both what ('Search and manage Confluence pages and spaces using CQL, read/create/update pages with Markdown support') and when ('Use when working with Confluence documentation') with explicit trigger guidance. | 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) further distinguishes it from generic documentation or wiki skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
72%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 skill with excellent actionability and progressive disclosure. Commands are concrete and executable with clear examples. The main weaknesses are some verbosity in explanations (particularly around authentication and the check command) and missing explicit validation/feedback loops for operations that modify content.
Suggestions
Consolidate the repeated explanations of what the check command validates - it's described in both Setup Verification and the check command section
Add explicit validation steps or feedback loops for the page create/update workflow, even if just a brief note about verifying success after operations
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some unnecessary verbosity, such as explaining what the check command validates in multiple places and repeating information about authentication options. Some sections could be tightened. | 2 / 3 |
Actionability | Provides fully executable commands throughout with specific examples, copy-paste ready bash commands, and concrete configuration file examples. Every command includes working syntax with real arguments. | 3 / 3 |
Workflow Clarity | Setup and verification steps are clear with the check command, but the skill lacks explicit validation checkpoints for content creation/update workflows. The reference to creating-content.md for write operations is appropriate but the main skill doesn't show feedback loops for error recovery. | 2 / 3 |
Progressive Disclosure | Excellent structure with clear overview, well-signaled one-level-deep references to creating-content.md and permissions.md, and logical organization. Quick examples are inline while detailed content is appropriately linked. | 3 / 3 |
Total | 10 / 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.
Install with Tessl CLI
npx tessl i odyssey4me/confluence@0.2.2Reviewed
Table of Contents