CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

acli

Use acli (Atlassian CLI) to interact with Jira Cloud — create, search, view, link, and edit work items via shell commands instead of MCP tools. Prefer acli over Atlassian MCP to minimize token usage.

66

Quality

83%

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

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

Highly actionable and workflow-safe: executable commands throughout, exact error messages and workarounds, and a sequenced story-creation pattern with validation checkpoints and per-failure error-recovery paths. The main weakness is token efficiency — eight verbatim guard invocations and a duplicated verification block — plus a body long enough that some sections belong in reference files.

Suggestions

Replace the eight verbatim repetitions of the jira-site-guard.sh invocation with one defined guard snippet in the Authentication section and a one-line instruction to prepend it to every mutating acli command.

Deduplicate the JQL parent/label verification block — state it once (e.g., in 'Capturing created issue keys') and cross-reference it from 'Known limitations' instead of repeating both commands twice.

Move the auth-guard internals and the link-direction semantics ('--in is the BLOCKER, --out is the BLOCKED issue' plus read-back inversion) into a reference file to shorten the SKILL.md body.

DimensionReasoningScore

Conciseness

Mostly operational with no padded conceptual explanations, but noticeable duplication: the '[ -x "${CLAUDE_PLUGIN_ROOT:-}/scripts/jira-site-guard.sh" ] ...' guard line appears verbatim 8+ times, and the JQL parent/label verification commands are repeated in both 'Known limitations' and 'Capturing created issue keys'. Matches the 3 anchor ('mostly efficient but ... could be tightened'); not 4 because the repetition is more than minor, and not 2 because there is no over-explanation of concepts Claude already knows.

3 / 5

Actionability

Every section provides copy-paste-ready executable commands with exact flags, jq pipelines, the bulk JSON schema, and literal error messages (e.g. '✗ Error: Please select valid parent issue.'). Fully executable with the common cases covered — matches the 5 anchor.

5 / 5

Workflow Clarity

'Workflow pattern for story creation' gives a 7-step ordered sequence with step 4 'Capture returned issue keys' plus a jq key-extraction snippet, post-write verification via JQL ('confirm the story is parented'), and a dedicated error-handling section with recovery paths per failure mode (DNS block, auth, project/parent not found, rate limit). Clear sequence with explicit validation steps and error-recovery feedback loops — matches the 5 anchor; the batch-operation validation cap does not apply because verification is present.

5 / 5

Progressive Disclosure

Good structure with clear section headers, and the ADF detail is properly split out behind a bold, clearly signaled one-level reference ('Before writing any description or comment to Jira, read .claude/refs/jira-adf.md'). Minor gaps: the ~320-line body inlines content (auth-guard internals, link-direction semantics, known limitations) that could live in reference files — matches the 4 anchor; not 5 because the split is only partial.

4 / 5

Total

17

/

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, concise description that names the tool, domain, transport, and five concrete operations, with explicit routing guidance against Atlassian MCP. The remaining gaps are missing natural synonyms ('tickets', 'issues', 'stories') and the absence of an explicit 'Use when...' trigger clause.

DimensionReasoningScore

Specificity

Names the tool and domain ('acli (Atlassian CLI) to interact with Jira Cloud') and lists five concrete actions ('create, search, view, link, and edit work items'), but omits body-covered operations such as commenting and bulk creation. Matches the 4 anchor ('several specific actions; minor gaps in coverage'); not 3 because coverage far exceeds 1-2 actions, and not 5 because comment/bulk-create are core operations left unstated.

4 / 5

Completeness

The 'what' is explicit ('interact with Jira Cloud — create, search, view, link, and edit work items via shell commands') and a 'when' is present via the routing directive 'Prefer acli over Atlassian MCP to minimize token usage', but there is no explicit 'Use when...' trigger clause. Fits the 4 anchor ('when' could be more explicit or specific); not 3 because the when-guidance is stated rather than merely implied, and not 5 because no concrete trigger phrases are given.

4 / 5

Trigger Term Quality

Includes strong natural terms — 'Jira Cloud', 'Atlassian', 'work items', 'shell commands', 'MCP tools' — but misses common variations users actually say such as 'tickets', 'issues', 'stories', or 'epics'. Good coverage with a few natural terms missing matches the 4 anchor; not 5 because synonym coverage is incomplete.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Jira work-item management via a specific named CLI) with explicit disambiguation from the main competing transport ('instead of MCP tools', 'Prefer acli over Atlassian MCP'). Minimal conflict risk — matches the 5 anchor.

5 / 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: 1 missing

Warning

Total

15

/

16

Passed

Repository

whimzyLive/nightshift-ai

Path

plugins/sdlc/skills/acli/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.