CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

jira-spaces

Manage Confluence spaces for project documentation. Create, list, and delete spaces with templates. Use when setting up project documentation structure or managing Confluence content areas.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./data/skills-md/01000001-01001110/agent-jira-skills/jira-spaces/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 content is genuinely actionable — executable fetch examples, endpoint and error tables, and key-format rules cover the common Confluence space operations. Its weaknesses are verbosity (full request/response JSON for every endpoint and a duplicative 'Common Patterns' section), no validation loop around the destructive delete operation, and a monolithic single-file layout whose only external references (the scripts) are missing from the bundle.

Suggestions

Add an explicit verification loop around space deletion: confirm the space key exists via GET /space/{spaceKey} and show its page count before DELETE, and check the async deletion status afterward, so the destructive workflow has real checkpoints.

Trim to one canonical request+response example per operation and cut the 'Common Patterns' create example (it duplicates the Create section); move the full endpoint reference and error tables into a references/ file, keeping SKILL.md as an overview.

Ship the scripts the document promises (create-space, delete-space, list-spaces, run.js) or remove the 'Scripts' and 'Usage Examples' sections, and define the auth/CONFLUENCE_URL variables once in the Prerequisites section so the code blocks are copy-paste runnable.

DimensionReasoningScore

Conciseness

The body is mostly efficient (compact endpoint/error tables, lean code blocks) but includes unnecessary padding: a full request+response JSON pair for every operation, an explanatory intro sentence ("Spaces are the top-level containers for organizing project documentation, wikis, and knowledge bases"), a Space Types table, and a 'Common Patterns' section whose create-space example largely duplicates the earlier Create request. This matches the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than the 4 anchor, where over-explanation would be only minor.

3 / 5

Actionability

Concrete, near-complete guidance throughout: real fetch code for create/list/delete, an endpoint table, key-format rules, an error table with resolutions, and bash usage examples — matching the 'mostly executable guidance; concrete code or commands with minor gaps' anchor. It is not a 5 because the examples reference undefined variables (${CONFLUENCE_URL}, ${auth} with no auth-construction shown) and the 'Scripts' section lists create-space/delete-space/list-spaces that do not exist in the bundle, so the commands cannot be run as written.

4 / 5

Workflow Clarity

Deleting a space is destructive ("WARNING: Deleting a space removes all pages and content permanently!") yet the body provides no verification step before or after deletion — the delete section is just a bare request, and the 'Common Patterns' create-then-populate flow has no checkpoints either. Per the judging guideline capping destructive/batch operations without validation at 3, this sits at the 'steps listed but validation gaps' anchor; it is not a 2 because the per-operation instructions themselves are well-defined and error codes are mapped to resolutions.

3 / 5

Progressive Disclosure

The body has good section structure but the entire API reference (endpoints, request/response payloads, error handling, ~220 lines) is inlined in SKILL.md when it could be split into reference files, matching the 'content that should be separate is inline' part of the 3 anchor. Additionally, the 'Scripts' table and 'Usage Examples' reference files (create-space, delete-space, list-spaces, run.js) that do not exist in the bundle, so the references it does make are broken rather than clearly signaled one-level-deep pointers.

3 / 5

Total

13

/

20

Passed

Description

75%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.

The description is well-constructed: it names concrete capabilities (create, list, delete spaces) and includes an explicit 'Use when' clause with reasonable trigger phrases. It stays slightly below top marks due to missing natural synonyms (wiki), a claimed 'templates' capability not documented in the body, and minor overlap risk with closely related Jira documentation skills.

DimensionReasoningScore

Specificity

"Create, list, and delete spaces with templates" names the domain (Confluence spaces) and several concrete actions, matching the 'lists several specific actions; minor gaps in coverage' anchor. It is not a 5 because coverage is incomplete — get space details, list space content, and the claimed 'templates' capability are never actually documented — and not a 3 because more than 1-2 concrete actions are explicitly stated.

4 / 5

Completeness

Both parts are present: the 'what' is "Manage Confluence spaces... Create, list, and delete spaces" and the 'when' is explicit ("Use when setting up project documentation structure or managing Confluence content areas"), with no missing trigger clause so the 3-cap does not apply. It is not a 5 because the 'when' triggers are less concrete than the anchor's example and omit user-shaped phrases like 'create a wiki' or 'set up a Confluence space for a team'.

4 / 5

Trigger Term Quality

Natural phrases like "Confluence spaces", "project documentation", "documentation structure", and "content areas" give good keyword coverage a user would plausibly say. It falls short of the 5 anchor because common synonyms such as "wiki", "wiki spaces", or "Confluence Cloud" are missing, but it clearly exceeds the 3 anchor's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

"Confluence spaces" is a clear, mostly distinct niche with specific triggers, matching the 'mostly distinct; minor overlap risk with closely related skills' anchor — the body itself lists sibling skills (jira-projects, jira-issues) it could be confused with. It is not a 5 because the skill is named jira-spaces while describing Confluence, and the generic 'project documentation' framing creates residual overlap with other documentation skills.

4 / 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

NeverSight/learn-skills.dev

Path

data/skills-md/01000001-01001110/agent-jira-skills/jira-spaces/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.