CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

publish-to-confluence

Publish any markdown file from the vault to Confluence with format conversion and approval gate

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/publish-to-confluence/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is maximally lean but is pure delegation: it directs Claude to read and execute an external playbook that is absent from this bundle (and, given the skill's own name, possibly a circular self-reference), then follow additional missing rule files. No task steps, validation checkpoints, or navigable in-bundle content exist, leaving the skill unexecutable as written.

Suggestions

Inline the core publish workflow (format conversion, approval gate, publishing steps) or bundle the authoritative playbook as a references/ file instead of pointing to `.claude/skills/publish-to-confluence/SKILL.md`, which is absent from this bundle and plausibly circular given this skill's own name.

Add explicit validation and approval-gate checkpoints in the body — publishing to Confluence is an outward-facing operation, so the absence of verification steps caps workflow clarity.

Make the Antigravity substitution rule concrete with a worked example mapping one `.claude/agents/<name>` path to its `.agents/agents/<name>.md` counterpart.

DimensionReasoningScore

Conciseness

The body is five lines with zero padding or over-explanation — every sentence is an instruction or a substitution rule. This matches the level-5 anchor (lean and efficient, every token earns its place).

5 / 5

Actionability

The pointers are concrete (exact paths, the "invoke_subagent" tool name), but the specific steps to execute the actual publishing task are entirely delegated to files that do not exist in this bundle — and the primary target, `.claude/skills/publish-to-confluence/SKILL.md`, is plausibly a circular self-reference since this skill is itself named publish-to-confluence. Nothing executable for the task itself is provided, matching the level-2 anchor (minimal concrete guidance, missing the specific steps to execute).

2 / 5

Workflow Clarity

Only a rough meta-sequence exists (read playbook → execute it as written → follow cog.md rules), with no task-level steps and no validation or approval-gate checkpoints in the body for an outward-facing publish operation. This matches the level-2 anchor (rough sequence present but many gaps, validation absent) and falls below the level-3 cap that applies to operations like publishing.

2 / 5

Progressive Disclosure

Scored against the actual bundle structure: no references/, scripts/, or assets/ directories exist, and all three referenced paths (`.claude/skills/publish-to-confluence/SKILL.md`, `.agents/rules/cog.md`, `.agents/agents/<name>.md`) live outside the bundle. The reference chain also nests multiple levels (SKILL.md → playbook → agent workers → substituted agent files), matching the level-2 anchor (minimal structure, references buried/unavailable).

2 / 5

Total

11

/

20

Passed

Description

70%Weight 40%Scale 1-5

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

A lean, specific description with good natural trigger terms and a distinct Confluence-publishing niche. Its main defect is the absent "Use when..." trigger clause, which caps completeness and leaves the "when to use this skill" question unanswered.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to publish or update notes/pages on Confluence, or mentions Confluence, the wiki, or the vault."

Include common trigger synonyms such as "Atlassian", "wiki", "Confluence page", and "documentation" to broaden natural keyword coverage.

Briefly state what format conversion covers (e.g., markdown to Confluence storage format, tables, macros) to strengthen specificity and completeness.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Publish any markdown file from the vault to Confluence", "format conversion", "approval gate" — with only minor gaps (no detail on page updates, attachments, or storage-format specifics). It exceeds the level-3 anchor (which covers only 1-2 concrete actions) but is not comprehensive enough for level 5.

4 / 5

Completeness

The "what" is clearly stated (publishing markdown from the vault to Confluence with format conversion and an approval gate), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. This matches the level-3 anchor exactly: clear "what", "when" missing.

3 / 5

Trigger Term Quality

Strong natural keywords are present: "Publish", "markdown", "vault", "Confluence", "approval gate" — phrases a user would naturally say. Common variations and synonyms such as "Atlassian", "wiki", "Confluence page", or "docs" are missing, so it falls short of the comprehensive level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

"Publish any markdown file from the vault to Confluence" carves out a clear niche — Confluence publishing — anchored by a distinctive platform-specific trigger term ("Confluence"). Minimal conflict risk with other skills; matches the level-5 anchor (clear niche with distinct triggers).

5 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

huytieu/COG-second-brain

Path

.agents/skills/publish-to-confluence/SKILL.md

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.