fix-github-issue
Fix GitHub issues using gh CLI. Use when asked to fix, resolve, or address a GitHub issue. Creates fixes on separate branches, runs tests locally, and creates PRs when tests pass. Requires gh CLI authenticated and repo cloned locally.
100
Quality
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
100%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 well-crafted skill description that excels across all dimensions. It clearly specifies the workflow (fix issues → branch → test → PR), includes explicit 'Use when' triggers with natural language variations, and establishes clear boundaries through its gh CLI and local repo requirements. The description is concise yet comprehensive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Fix GitHub issues', 'Creates fixes on separate branches', 'runs tests locally', 'creates PRs when tests pass'. Also specifies requirements (gh CLI authenticated, repo cloned locally). | 3 / 3 |
Completeness | Clearly answers both what ('Fix GitHub issues...creates fixes on separate branches, runs tests locally, creates PRs') AND when ('Use when asked to fix, resolve, or address a GitHub issue') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'fix', 'resolve', 'address', 'GitHub issue', 'gh CLI', 'PR'. These are terms developers naturally use when working with GitHub issues. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on GitHub issues via gh CLI with a defined workflow (branch → test → PR). Distinct from general git skills or code review skills due to the specific issue-fixing workflow and gh CLI requirement. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill that efficiently guides Claude through the GitHub issue fixing workflow. It provides concrete, executable commands at each step with proper validation checkpoints for testing and CI. The content is appropriately concise while remaining comprehensive, with a useful quick reference section for rapid execution.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, assuming Claude's competence. No unnecessary explanations of what GitHub issues are, how git works, or what PRs do. Every section serves a purpose. | 3 / 3 |
Actionability | Provides fully executable bash commands throughout, with specific examples for each step. The quick reference section offers copy-paste ready commands for the entire workflow. | 3 / 3 |
Workflow Clarity | Clear 8-step sequence with explicit validation checkpoints: tests must pass before proceeding (step 5), CI monitoring with failure recovery loop (step 8). Feedback loops are well-defined for both local testing and CI failures. | 3 / 3 |
Progressive Disclosure | For a skill under 50 lines with no need for external references, the content is well-organized with clear sections. The quick reference at the end provides a condensed version for experienced users without requiring separate files. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- freekmurze/dotfiles
- Commit
355d067
- 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.