CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

80

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-pick-issue/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description with excellent trigger term coverage and completeness. The extensive list of trigger phrases ensures reliable skill selection, and the explicit negative boundary prevents conflicts with the issue creation skill. The main weakness is that the core capability description could be slightly more specific about what concrete actions are performed beyond browse/select/route.

DimensionReasoningScore

Specificity

The description mentions browsing issues, selecting one, routing to a pipeline skill, and local-first dependency resolution, but the core actions (browse, select, route) are somewhat generic. It does mention filtering by Arness labels and greenfield feature backlog support, which adds some specificity, but it doesn't list multiple concrete actions as clearly as a score-3 example.

2 / 3

Completeness

The description clearly answers both 'what' (browse issues filtered by Arness labels, select one, route to appropriate pipeline skill, local-first dependency resolution) and 'when' (explicit trigger phrases plus a negative boundary 'Do NOT use this for creating new issues'). The extensive trigger list and explicit exclusion clause make this highly complete.

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would say: 'pick issue', 'work on issue', 'grab issue', '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 backlog', etc. This provides excellent coverage of natural language variations.

3 / 3

Distinctiveness Conflict Risk

The description is highly distinctive with Arness-specific terminology, explicit trigger phrases, and a clear negative boundary ('Do NOT use this for creating new issues — use /arn-code-create-issue'). This makes it very unlikely to conflict with other skills, as it carves out a specific niche of issue picking/selection within the Arness ecosystem.

3 / 3

Total

11

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a highly actionable and well-structured workflow skill with clear step sequencing, concrete commands, and thorough error handling. However, it suffers significantly from verbosity — the inline content covers multiple platforms, greenfield integration, drift detection, and exhaustive error cases that would be better served by reference files. The skill tries to be a comprehensive manual rather than a concise orchestration guide.

Suggestions

Extract platform-specific flows (GitHub vs Jira) into separate reference files (e.g., github-issue-ops.md, jira-issue-ops.md) and keep only the branching logic inline to dramatically reduce token count.

Move the extensive error handling section into a dedicated reference file (e.g., error-handling.md) and keep only the most critical 3-4 error cases inline.

Extract Step 6.5 (Spec Freshness Gate) and Step 7 (Hand Off) detail — especially the sub-feature context passing — into a reference file, keeping only the high-level decision flow inline.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines with extensive branching for multiple platforms (GitHub, Jira, Bitbucket), detailed sub-feature handling, drift detection, and exhaustive error handling. Much of this could be offloaded to reference files. The greenfield backlog integration alone adds significant complexity that could be a separate reference document.

1 / 3

Actionability

The skill provides concrete, executable commands throughout (gh issue list, gh issue view, gh label create, JQL queries), specific output format examples for displayed issue lists, and clear instructions for each platform path. Code blocks are copy-paste ready.

3 / 3

Workflow Clarity

The multi-step workflow is clearly sequenced (Steps 1-7) with explicit validation checkpoints (prerequisite checks, spec freshness gate, drift severity branching), feedback loops (filter adjustment, re-validation), and clear decision points with user interaction at each stage. Error recovery paths are well-defined.

3 / 3

Progressive Disclosure

The skill references one external file (greenfield-backlog-resolution.md) and platform-labels.md appropriately, but the vast majority of content is inline. The Jira-specific flows, detailed error handling, sub-feature handling, and drift detection logic could be split into reference files to keep the main skill leaner. The monolithic structure makes it harder to navigate.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
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.