CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

atlassian-templates

Atlassian Template and Files Creator/Modifier expert for creating, modifying, and managing Jira and Confluence templates, blueprints, custom layouts, reusable components, and standardized content structures. Use when building org-wide templates, custom blueprints, page layouts, and automated content generation.

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/atlassian-templates/SKILL.md

The canonical home for this skill is atlassian-templates in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

66%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 well structured with concrete commands, exact UI/admin paths, and exemplary validation-and-rollback checkpoints in its workflows. Its weaknesses are token padding in the lifecycle and handoff sections and, critically, that every referenced bundle file is missing from the skill as shipped, which breaks progressive disclosure and makes the documented canonical deployment path non-executable.

Suggestions

Ship the referenced bundle files (references/template-design-patterns.md, references/governance-framework.md, scripts/template_scaffolder.py) or inline their essential content — as delivered, all referenced paths are dangling and the canonical deployment path cannot run.

Include one complete Confluence storage-format (XHTML) example inline so the skill contains a deployable artifact even without the scaffolder script.

Trim the padded sections to improve token efficiency: the marketing intro sentence, the lifecycle steps Claude does not execute (Train/Monitor/Iterate), and the handoff-protocol table.

DimensionReasoningScore

Conciseness

The technical core (template tables, scaffolder commands, MCP operations) is tight and table-driven, but there are several padded sections: the marketing intro ('Ensures consistency, accelerates content creation, and maintains org-wide standards'), an 11-step creation lifecycle containing steps Claude does not execute ('Train: Educate users on template usage', 'Monitor: Track adoption and gather feedback'), and a large handoff-protocol table of org-chart context. This is 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4's 'minor instances'.

3 / 5

Actionability

Concrete, executable guidance dominates: 'python3 scripts/template_scaffolder.py meeting-notes', exact UI paths ('Space settings > Templates', 'Settings > Issues > Field configurations'), the REST endpoint '/rest/api/3/fieldconfiguration', and honest parameter guidance ('discover exact parameter names from each tool's schema at call time'). Falls short of 5 because the canonical deployment path depends on scripts/template_scaffolder.py, which is absent from the bundle, and the one complete inline example is explicitly non-deployable legacy markup ('will be rejected by mcp__atlassian__createConfluencePage').

4 / 5

Workflow Clarity

Multi-step processes carry explicit validation and rollback loops: 'Test: Validate with sample data — confirm template renders correctly in preview before publishing', 'Verify: Confirm deployment success; roll back to previous version if errors occur', blueprint 'Test blueprint creation flow end-to-end with a sample space', a post-deployment validation checkpoint ('Retrieve the created/updated page... If any check fails: revert'), and per-space verification in batch deployment. This matches the 5 anchor's explicit validation steps and error-recovery feedback loops.

5 / 5

Progressive Disclosure

The body is well-sectioned and its references are clearly signaled ('See `references/template-design-patterns.md`', 'references/governance-framework.md', 'python3 scripts/template_scaffolder.py', 'project-management/references/atlassian-mcp-tools.md'), but no references/, scripts/, or assets/ directory exists in the bundle — every referenced path is missing. Navigation is therefore broken: the canonical tool list, design patterns, governance model, and the storage-format scaffolder the skill relies on are all dangling, leaving no working deployment artifact in the shipped skill.

2 / 5

Total

14

/

20

Passed

Description

83%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 strong description: it names the Jira/Confluence template domain explicitly, lists the artifact types it produces, and includes a concrete 'Use when...' trigger clause in third person. Deductions are minor — overlapping generic verbs (create/modify/manage), a few missing natural synonyms, and slight breadth from 'reusable components'/'automated content generation'.

DimensionReasoningScore

Specificity

The description names the domain comprehensively ('Jira and Confluence templates, blueprints, custom layouts, reusable components, and standardized content structures') and lists three actions ('creating, modifying, and managing'), but those verbs are overlapping near-synonyms rather than the distinct concrete action set of the 5 anchor ('extract text, fill forms, merge documents, convert pages'). Above 3 because domain-object coverage is comprehensive; below 5 because the actions themselves are generic.

4 / 5

Completeness

Explicitly answers both questions: what — 'creating, modifying, and managing Jira and Confluence templates, blueprints, custom layouts...' — and when, via a concrete 'Use when building org-wide templates, custom blueprints, page layouts, and automated content generation' clause with concrete trigger phrases. Matches the 5 anchor directly; 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Jira', 'Confluence', 'templates', 'blueprints', 'page layouts', 'org-wide templates' — phrases users would naturally say. Missing common variations a user might use ('issue templates', 'space templates', 'sprint retro template'), so it falls short of the 5 anchor's comprehensive synonym coverage; clearly above 3's 'some relevant keywords but missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The Jira/Confluence template niche is mostly distinct with clear triggers, but the tail phrases 'reusable components' and 'automated content generation' broaden it, and the body's handoff table implies sibling Atlassian skills (Confluence Expert, Jira Expert) that share some trigger territory — minor overlap risk with closely related skills, matching the 4 anchor rather than 5's 'minimal conflict risk'.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 9 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/atlassian-templates/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.