CtrlK
BlogDocsLog inGet started
Tessl Logo

gh-issues

Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5] [--notify-channel -1002381931352]

72

2.00x
Quality

61%

Does it follow best practices?

Impact

100%

2.00x

Average score across 3 eval scenarios

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./openclaw/skills/gh-issues/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 effectively communicates specific capabilities around GitHub issue management and automated PR workflows, giving it a clear niche. However, it lacks an explicit 'Use when...' clause, and the bulk of the description is consumed by CLI flag documentation rather than natural trigger terms that would help Claude select this skill in response to user requests.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to automatically fix GitHub issues, create pull requests from issues, or monitor and respond to PR review feedback.'

Replace or supplement the CLI flag listing with natural language trigger terms users would say, such as 'bug fixes', 'pull requests', 'code review comments', 'automated issue resolution', 'GitHub automation'.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: fetch GitHub issues, spawn sub-agents to implement fixes, open PRs, monitor PR review comments, and address review comments. These are clear, actionable capabilities.

3 / 3

Completeness

The 'what' is well covered (fetch issues, implement fixes, open PRs, monitor reviews). However, there is no explicit 'Use when...' clause or equivalent trigger guidance — the 'Usage:' line describes CLI syntax, not when Claude should select this skill.

2 / 3

Trigger Term Quality

Contains good keywords like 'GitHub issues', 'PRs', 'PR review comments', 'fixes', but the description is heavily dominated by CLI flag documentation rather than natural language terms users would say. Missing natural phrases like 'bug fixes', 'pull requests', 'code review'.

2 / 3

Distinctiveness Conflict Risk

Very distinct niche: automated GitHub issue triage, fix implementation via sub-agents, and PR lifecycle management. The specific command '/gh-issues' and detailed flags make it clearly distinguishable from other skills.

3 / 3

Total

10

/

12

Passed

Implementation

55%

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

This skill is impressively thorough and highly actionable, with excellent workflow clarity including validation checkpoints, error handling, and multiple operational modes (cron, watch, dry-run, fork). However, it is severely bloated — the monolithic structure with embedded sub-agent prompts, repeated token resolution blocks, and redundant warnings makes it a poor fit for context window efficiency. Splitting sub-agent templates and the review handler into separate files would dramatically improve both conciseness and progressive disclosure.

Suggestions

Extract the two sub-agent prompt templates (fix agent and review handler agent) into separate referenced files (e.g., TEMPLATES/fix-agent.md and TEMPLATES/review-agent.md) to reduce the main skill by ~40%.

Consolidate GH_TOKEN resolution into a single reusable section referenced by name, rather than repeating the full resolution logic 4+ times across the skill and sub-agent prompts.

Remove redundant warnings (e.g., 'Do NOT use gh CLI' appears 5 times — state it once at the top and trust Claude to remember).

Consider splitting Phase 6 (PR Review Handler) into a separate skill file referenced from the main skill, since --reviews-only mode treats it as an independent workflow.

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~600+ lines. While the complexity of the task justifies significant length, there is substantial redundancy — GH_TOKEN resolution is repeated 4+ times across the main body and sub-agent prompts, the 'do NOT use gh CLI' warning appears 5+ times, and authentication error messages are duplicated. Many sections explain things Claude already knows (how to parse JSON, how git remotes work, HTTPS vs SSH URL formats). The sub-agent prompts alone are massive and could be referenced from a separate file.

1 / 3

Actionability

The skill provides fully executable curl commands, git commands, and jq expressions throughout. Every API call includes the exact endpoint, headers, and request body. The sub-agent prompts are copy-paste ready with clear variable substitution points. Error handling includes specific HTTP status codes and exact error messages to display.

3 / 3

Workflow Clarity

The 6-phase workflow is clearly sequenced with explicit validation checkpoints: Phase 4 has 7 sequential pre-flight checks including dirty tree detection, remote access verification, token validation, existing PR detection, branch existence checks, and claim-based deduplication. Each phase has clear entry/exit conditions, error handling with specific stop conditions, and feedback loops (e.g., sub-agent retry on test failure, watch mode polling). The cron vs normal mode branching is explicitly documented at each decision point.

3 / 3

Progressive Disclosure

This is a monolithic wall of text with no references to external files. The sub-agent prompt templates alone account for roughly 40% of the content and could easily be split into separate template files. The Phase 6 review handler is essentially a second skill embedded inline. The argument table, sub-agent prompts, and review handler could all be separate referenced documents, dramatically reducing the main skill's size.

1 / 3

Total

8

/

12

Passed

Validation

63%

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

Validation7 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

7

/

11

Passed

Repository
trpc-group/trpc-agent-go
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.