CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

process-issues

Process GitHub Issues - fetch open issues, read comments, analyze suggestions, find similar, create Beads tasks, propose fix plan

55

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/process-issues/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill body is highly actionable with concrete gh/bd commands and clear templates, and the workflow is well-sequenced with validation and a user approval gate. However, it is noticeably verbose due to systematic duplication between the "CRITICAL REQUIREMENTS" sections and the Workflow steps, and it is a monolithic file where command references, subagent routing tables, and templates should be split into reference files.

Suggestions

Merge the duplicated guidance: the CRITICAL REQUIREMENTS sections (comments, similar-issue search, Beads) repeat the Workflow steps nearly verbatim — state each rule once and reference it.

Move the Quick Commands Reference, the subagent/label/category tables, and the markdown output templates into files under references/ and link to them from the body.

Add an explicit error-recovery loop after `pnpm type-check`/`pnpm build` (fix failures and re-run before closing the issue and Beads task).

DimensionReasoningScore

Conciseness

The ~495-line body duplicates guidance wholesale: comment-reading rules appear in "READ ISSUE COMMENTS (MANDATORY)" and again in Step 2, similar-issue search in sections 3 and Step 2.4, subagent routing in two separate tables, and bd create syntax twice — plus heavy ALL-CAPS/bold "YOU MUST" padding. Not a 3 because this goes beyond "some unnecessary explanation" into several genuinely redundant sections. Not a 1 because the bulk is domain-specific commands and rules rather than explanations of concepts Claude already knows.

2 / 5

Actionability

Commands are copy-paste ready and executable (`gh issue list --state open --json number,title,labels,body`, `bd create "<issue_title>" -t <bug|task|feature> -p <1-3> --external-ref="gh-<number>"`, `pnpm type-check`), and complete templates (analysis plan, Beads task description, close comment) cover the common cases. Not a 4 because there are no meaningful gaps — even edge handling like API-based comment fetching is given concretely.

5 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced with explicit validation (`pnpm type-check`, `pnpm build`), a user-approval gate before execution (Step 5 → Step 6 "After User Approval"), and a Verification Checklist — but no explicit error-recovery loop (what to do when the build fails) beyond noting "known pre-existing failures". Not a 5 because the validate → fix → re-validate feedback loop is implied rather than spelled out; not a 3 because checkpoints are explicit and present throughout a batch operation.

4 / 5

Progressive Disclosure

No references/, scripts/, or assets/ files exist — everything is inlined in a single ~500-line SKILL.md, including a Quick Commands Reference, three overlapping subagent/priority tables, and full output templates that clearly belong in separate reference files. Not a 2 because section structure is present and reasonably organized (it is not a wall of text, and it does point to .claude/docs/beads-quickstart.md and the process-logs skill); not a 4 because the bulk reference material remains inline rather than split out.

3 / 5

Total

14

/

20

Passed

Description

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

The description is strong on concrete action coverage but weak on trigger guidance. It clearly communicates what the skill does but gives no indication of when it should be invoked, and its keyword coverage is narrow for a domain where users employ many synonyms.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to process, triage, or work through GitHub issues, bug reports, or the issue backlog".

Include natural synonyms users would actually say — "issue triage", "bug reports", "backlog grooming" — alongside "GitHub Issues".

Clarify the jargon term "Beads tasks" (e.g. "create Beads tracking tasks") so the dependency is legible to users unfamiliar with Beads.

DimensionReasoningScore

Specificity

"fetch open issues, read comments, analyze suggestions, find similar, create Beads tasks, propose fix plan" lists six concrete, distinct actions that comprehensively cover the skill's workflow. Not a 4 because there is no significant gap in the action coverage for this domain.

5 / 5

Completeness

The "what" is clearly stated through the explicit action list, but there is no "Use when..." clause or any equivalent trigger guidance, which caps completeness at 3 per the rubric guidelines. Not a 2 because the "what" half is concrete and unambiguous, not vague.

3 / 5

Trigger Term Quality

"GitHub Issues" and "Beads tasks" are relevant keywords, but common natural variations users would say — "issue triage", "bug reports", "backlog", "issue tracker" — are absent. Not a 4 because keyword coverage is limited to the single domain noun rather than a good spread of natural terms.

3 / 5

Distinctiveness Conflict Risk

"Process GitHub Issues ... create Beads tasks" carves out a distinct issue-triage niche with tool-specific terms (Beads, external-ref), so overlap risk with other skills is minor. Not a 5 because the description omits explicit trigger phrases, so distinctiveness rests on domain naming rather than distinct triggers.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (502 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

maslennikov-ig/claude-code-orchestrator-kit

Path

.claude/skills/process-issues/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.