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.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./project-management/skills/atlassian-templates/SKILL.md

Quality

Content

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

A well-structured, actionable skill body with strong validation and feedback loops in its deployment workflows. The main weakness is conciseness: a non-deployable legacy example, generic macro guidance, and a broken reference path add tokens without proportional value.

Suggestions

Replace the inlined legacy wiki-markup Meeting Notes example with a pointer to the scaffolder output or a storage-format (XHTML) snippet, removing the lengthy 'this is not storage format' warning.

Move the Handoff Protocols table and generic Macro Usage Guidelines into references/ (e.g. governance-framework.md or a new handoffs.md) and link from the body.

Fix or remove the missing 'project-management/references/atlassian-mcp-tools.md' canonical tool-list reference, or inline the canonical tool list so the link is not a dead end.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and free of basic-concept padding, but inlines a non-deployable legacy wiki-markup example with a lengthy format warning and includes generic 'Macro Usage Guidelines' and a long handoff table that could be tightened or moved to references.	3 / 5
Actionability	Provides concrete, real executable commands (the scaffolder invocations) and parameterized MCP tool examples, but uses angle-bracket placeholders and defers exact parameter names to call time, leaving minor gaps from copy-paste readiness.	4 / 5
Workflow Clarity	Workflows are clearly sequenced with explicit validation checkpoints ('confirm template renders correctly in preview before publishing', 'roll back to previous version if errors occur'), a batch-deploy verify-each-create loop, and a 'Quality Gates' checklist for destructive/batch operations.	5 / 5
Progressive Disclosure	Good overview structure with well-signaled one-level-deep references to existing files (template-design-patterns.md, governance-framework.md, template_scaffolder.py), but the canonical 'project-management/references/atlassian-mcp-tools.md' reference is missing from the bundle and some content (full example, handoff table) is inlined.	4 / 5
	Total	16 / 20 Passed

Description

78%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, domain-specific description that clearly states capabilities and includes an explicit 'Use when' trigger clause. It is held below the top band only by mild abstraction in a few objects and trigger phrases that are not the most natural user wording.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('creating, modifying, and managing Jira and Confluence templates, blueprints, custom layouts, reusable components') but drifts slightly abstract with 'standardized content structures', so it sits just below the comprehensive 5-anchor.	4 / 5
Completeness	Both 'what' (the creating/modifying/managing actions) and 'when' ('Use when building org-wide templates, custom blueprints, page layouts, and automated content generation') are present, but the 'when' could be more explicit with concrete user-sayable trigger phrases.	4 / 5
Trigger Term Quality	Good natural keywords ('Jira', 'Confluence', 'templates', 'blueprints', 'custom layouts', 'page layouts') with a 'Use when building...' clause, but lacks synonyms and common user phrasings like 'when the user asks to create a meeting-notes template'.	4 / 5
Distinctiveness Conflict Risk	Clear niche (Atlassian Jira/Confluence template and blueprint creation) with distinct triggers and minimal overlap with adjacent admin or general Confluence skills.	5 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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: alirezarezvani/claude-skills
Path: project-management/skills/atlassian-templates/SKILL.md
Commit: 19392f7

Reviewed: ~1 hour ago

Table of Contents

Discovery Implementation Validation

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.