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
76%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-pick-issue/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
1fe948f
Table of Contents
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.