CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-pick-issue

This skill should be used when the user says "pick issue", "work on issue", "arness code pick", "arness code pick issue", "arn-code-pick-issue", "grab issue", "pick from backlog", "what should I work on", "show issues", "find issue", "browse issues", "next issue", "select issue", "choose issue", "what's unblocked", "work on next feature", "pick from feature tracker", or wants to browse issues filtered by Arness labels, select one, and route it to the appropriate Arness pipeline skill for implementation. Supports local-first dependency resolution from a greenfield feature backlog when available. Requires an issue tracker (GitHub or Jira) to be configured for remote issue browsing. Do NOT use this for creating new issues — use /arn-code-create-issue for that.

Quality

92%

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

88%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 highly actionable, well-sequenced pipeline skill: every step has executable commands, explicit prerequisite validation, conditional branches per tracker, and a gated drift check with user-feedback loops. The weaknesses are mild duplication — the Error Handling section restates several conditions already handled inline, and some local-backlog error entries overlap the externalized reference file.

Suggestions

Trim the Error Handling section to entries not already covered inline (e.g., drop 'gh CLI not authenticated', 'Label missing from repository', and 'No issues match filters', which restate Steps 1-3), cutting roughly a third of the section without losing coverage.

Deduplicate the identical no-results guidance in Step 3's GitHub and Jira branches by hoisting it to a single line after the branch examples.

Consider moving the greenfield-specific error entries (blocked features, decomposed feature selected, Feature Tracker parse/write failures) into references/greenfield-backlog-resolution.md next to the resolution workflow they describe, keeping the main body focused on the remote flow.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no concept-teaching padding, but the 18-entry Error Handling catalog restates roughly six conditions already covered inline (e.g., "gh CLI not authenticated", "Label missing from repository", "No issues match filters") and "If no results match the filters…" appears verbatim in both tracker branches. Efficient overall with trimming available — anchor 4, not 5; the systematic duplication keeps it above 3 only because the rest is lean.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready gh commands with exact flags and JSON fields ("gh issue list --label \"<label1>,<label2>\" --state open --limit 10 --json number,title,labels,createdAt,author"), exact JQL, exact display formats, a verbatim drift-detector agent prompt, and concrete file-detection paths. Matches the top anchor; the generic 'use the Atlassian MCP server' phrasing is inherent to MCP integration and doesn't leave a real gap.

5 / 5

Workflow Clarity

Steps 1–7 are clearly sequenced with explicit validation (git remote check, "gh auth status", MCP availability probe), a gated Step 6.5 with skip conditions, severity-based feedback loops (none/minor → proceed, moderate/major → ask user), and failure fallback ("If the drift detector itself fails … Do not block on a tool failure"). Batch label creation is check-then-act and flagged idempotent, so the destructive/batch cap does not apply — top anchor.

5 / 5

Progressive Disclosure

The greenfield procedure is properly externalized to a real, well-signaled one-level-deep reference ("Read ${CLAUDE_PLUGIN_ROOT}/skills/arn-code-pick-issue/references/greenfield-backlog-resolution.md for the full detection chain, resolution workflow, and sub-feature handling"), and cross-references to platform-labels.md and ensure-config.md are clearly signaled. However, the ~287-line body inlines a large error catalog that partially duplicates both the steps and the reference file — good structure with minor organization gaps, anchor 4 rather than the lean-overview anchor 5.

4 / 5

Total

18

/

20

Passed

Description

95%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 concrete capabilities, gives an exhaustive list of natural trigger phrases, and explicitly states both what the skill does and when to use it, including a negative boundary against a sibling skill. The only gap is that downstream behaviors (assessment, reject/defer options, spec routing targets) are only implied by 'route it to the appropriate Arness pipeline skill'.

DimensionReasoningScore

Specificity

Quotes several concrete actions — "browse issues filtered by Arness labels, select one, and route it to the appropriate Arness pipeline skill for implementation" plus "local-first dependency resolution from a greenfield feature backlog" — matching the anchor for several specific actions with minor gaps. Not 5 because the assessment/rejection loop and spec routing outcomes are not covered; not 3 because far more than 1-2 actions are named.

4 / 5

Completeness

Explicitly answers both: what ("browse issues filtered by Arness labels, select one, and route it to the appropriate Arness pipeline skill"; "local-first dependency resolution") and when ("should be used when the user says … or wants to browse issues"), with concrete trigger phrases and a negative boundary ("Do NOT use this for creating new issues — use /arn-code-create-issue"). Clearly the top anchor, not 4, since the 'when' is fully explicit with concrete triggers.

5 / 5

Trigger Term Quality

Comprehensive natural phrasings a user would actually say: "pick issue", "grab issue", "what should I work on", "next issue", "what's unblocked", "pick from feature tracker", plus the exact skill name. Matches the comprehensive-coverage anchor; no common variation is obviously missing, so not 4.

5 / 5

Distinctiveness Conflict Risk

Clear niche — issue selection and routing within the Arness pipeline — with explicit disambiguation against the sibling skill ("Do NOT use this for creating new issues"). Generic phrases like "show issues" carry at most minimal overlap risk, matching the clear-niche/minimal-conflict anchor rather than the minor-overlap anchor at 4.

5 / 5

Total

19

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-pick-issue/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.