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
61%
Does it follow best practices?
Impact
100%
2.00xAverage score across 3 eval scenarios
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/gh-issues/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 7 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
09cce3e
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.