CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

atlassian-mcp

Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying Jira issues with JQL filters, creating and updating tickets with custom fields, searching or editing Confluence pages with CQL, managing sprints and backlogs, setting up MCP server authentication, syncing documentation, or debugging Atlassian API integrations.

Quality

97%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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-engineered skill body: executable quick-start examples, a validated six-step workflow with explicit read-only probes before risky operations, hard guardrails in MUST DO/MUST NOT lists, and textbook progressive disclosure via a load-conditions table pointing to real one-level-deep references. The only flaw is minor repetition of validation guidance between the workflow and constraint sections.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — no padding explaining what Jira, Confluence, or MCP are, and every code block is directly usable. It falls short of 5 only through minor redundancy: the 'maxResults=1' validation probe is stated both in Core Workflow step 3 and again in MUST DO, and 'Test with read-only operations first' repeats workflow step 5's read-only probe.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready JQL and CQL samples, a real CLI command ('claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp'), a complete JSON server config with environment-variable token handling, and specific operational parameters (pagination 50-100 items per page, exponential backoff). Deferring tool-call specifics to references is explicitly justified ('Tool names differ between servers').

5 / 5

Workflow Clarity

The six-step Core Workflow is clearly sequenced with explicit validation checkpoints built in: 'validate with maxResults=1 before full execution' (step 3) and 'Confirm required scopes with a read-only probe before any write or bulk operation' (step 5), reinforced by MUST DO / MUST NOT checklists gating writes and bulk operations on confirmation. Not 4 — there are no real validation gaps, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The Reference Guide table gives Topic / Reference / Load When columns for all five bundle files, all of which exist and are exactly one level deep with no nested references (verified: 5 files, ~2,500 lines, no cross-file .md links). Quick-start samples are appropriately inline while bulk detail is pushed to references, making navigation easy.

5 / 5

Total

19

/

20

Passed

Description

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

An exemplary description: a one-sentence 'what' followed by an explicit 'Use when...' clause covering all major workflows of the domain. Concrete actions, natural trigger vocabulary, third-person voice, and a distinct Atlassian niche leave essentially nothing to improve.

DimensionReasoningScore

Specificity

The description lists seven concrete actions ('querying Jira issues with JQL filters, creating and updating tickets with custom fields, searching or editing Confluence pages with CQL, managing sprints and backlogs, setting up MCP server authentication, syncing documentation, or debugging Atlassian API integrations'), giving comprehensive coverage in third-person voice. It clearly matches the 5 anchor rather than 4 because no meaningful capability area of the domain is missing.

5 / 5

Completeness

It explicitly answers 'what' ('Integrates with Atlassian products to manage project tracking and documentation via MCP protocol') and 'when' with a dedicated 'Use when...' clause enumerating concrete trigger scenarios. This mirrors the 5 anchor example structure exactly; not 4, since the 'when' clause is explicit and specific.

5 / 5

Trigger Term Quality

It comprehensively covers natural terms users would actually say — Jira, JQL, tickets and issues (synonym pair), custom fields, Confluence, pages, sprints, backlogs, documentation, authentication — including both product names and query languages. Coverage is comprehensive for this domain, matching the 5 anchor rather than 4 ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (Atlassian MCP integration) with distinct triggers — Jira, Confluence, JQL, CQL, sprints, backlogs — that no generic document- or project-management skill would share. Conflict risk is minimal, matching the 5 anchor.

5 / 5

Total

20

/

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

Jeffallan/claude-skills

Path

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