CtrlK
BlogDocsLog inGet started
Tessl Logo

confluence-automation

Automate Confluence page creation, content search, space management, labels, and hierarchy navigation via Rube MCP (Composio). Always search tools first for current schemas.

74

1.73x
Quality

65%

Does it follow best practices?

Impact

90%

1.73x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/all-skills/skills/confluence-automation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description does a good job listing specific Confluence capabilities and identifying the integration mechanism, making it distinctive. However, it lacks an explicit 'Use when...' clause, which weakens its completeness for skill selection. Adding natural trigger terms and explicit usage guidance would improve its effectiveness.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about creating, updating, or searching Confluence pages, managing spaces, or working with Atlassian wiki content.'

Include additional natural trigger terms users might say, such as 'wiki', 'Atlassian', 'confluence page update', 'publish to confluence', or 'knowledge base'.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'page creation, content search, space management, labels, and hierarchy navigation'. Also specifies the integration method ('via Rube MCP (Composio)') and includes a procedural instruction ('Always search tools first for current schemas').

3 / 3

Completeness

The 'what' is well-covered with specific Confluence actions, but there is no explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied by the capabilities listed, which per the rubric caps completeness at 2.

2 / 3

Trigger Term Quality

Includes relevant keywords like 'Confluence', 'page creation', 'content search', 'space management', 'labels', and 'hierarchy navigation'. However, it misses common user variations like 'wiki', 'Atlassian', 'confluence page', 'update page', or 'publish to confluence' that users might naturally say.

2 / 3

Distinctiveness Conflict Risk

The description is clearly scoped to Confluence specifically, with the additional qualifier 'via Rube MCP (Composio)'. This creates a distinct niche that is unlikely to conflict with other skills unless there were multiple Confluence-related skills.

3 / 3

Total

10

/

12

Passed

Implementation

62%

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 reference skill for Confluence automation with clear workflow sequences and thorough coverage of pitfalls. Its main weaknesses are significant content duplication (pitfalls repeated in workflow sections and a dedicated section), lack of concrete executable examples showing actual tool invocation payloads, and being overly long for a single file without supporting bundle documents.

Suggestions

Add concrete tool invocation examples with actual parameter JSON for at least the create page and update page workflows, showing exact payload structure

Eliminate the duplicated 'Known Pitfalls' section by keeping pitfalls only under their respective workflow sections, or consolidate all pitfalls in one place and remove inline ones

Split detailed reference content (CQL operators, content formatting, quick reference table) into separate bundle files and reference them from the main SKILL.md

DimensionReasoningScore

Conciseness

The skill is reasonably well-organized but contains significant redundancy — the 'Known Pitfalls' section largely repeats pitfalls already listed under each workflow section. The Quick Reference table adds value but the overall document could be 30-40% shorter by deduplicating. Some explanations (e.g., pagination styles, content formatting basics) are things Claude already knows.

2 / 3

Actionability

The skill provides clear tool names, parameter names, and sequenced workflows, which is good. However, there are no concrete executable examples — no actual tool invocation snippets showing exact parameter structures or JSON payloads. The CQL examples are helpful but the core create/update workflows lack copy-paste-ready examples with actual parameter shapes.

2 / 3

Workflow Clarity

Workflows are clearly sequenced with numbered steps, labeled as [Required], [Optional], [Prerequisite], etc. The setup flow includes explicit validation (confirm ACTIVE status before proceeding). Update workflows explicitly require fetching current version first. The pitfalls sections serve as validation checkpoints by warning about common failure modes like version conflicts and duplicate titles.

3 / 3

Progressive Disclosure

The content is a monolithic single file with no bundle files to reference. While internally structured with clear sections and a quick reference table, the document is quite long (~200+ lines of dense content) and would benefit from splitting detailed CQL reference, content formatting guide, and pitfalls into separate files. The external link to Composio docs is helpful but insufficient for progressive disclosure.

2 / 3

Total

9

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
davepoon/buildwithclaude
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.