CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gh-cli

Use gh (GitHub CLI) for all GitHub operations — creating PRs, checking status, commenting, and capturing URLs. Prefer gh over GitHub MCP tools to minimize token usage.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

A highly actionable, well-structured skill body built almost entirely from executable gh commands, with an explicit ordered PR workflow, duplicate-PR validation, and an error-recovery table. The main improvement opportunities are consolidating the three overlapping PR-creation sections and adding a pre-merge CI verification step.

Suggestions

Consolidate 'Full PR creation workflow', 'Create a PR (minimal form)', and 'Capturing PR URL' into one section — all three repeat 'gh pr create' with the same --title/--base/--body pattern, which is the main conciseness drag.

Before the destructive 'gh pr merge --squash --delete-branch' step, require verification that CI is green (e.g. run 'gh pr checks' and only merge when all pass) — this closes the workflow-clarity validation gap and addresses the destructive-operation feedback-loop note.

Trim the 'Shell escaping rule' to the single directive ('Always use single-quoted <<'EOF'') with one correct example — the detailed WRONG-variant walkthrough re-teaches heredoc quoting Claude already knows.

DimensionReasoningScore

Conciseness

The body is dense with executable commands and tables and almost never explains concepts Claude already knows; the 'Why gh over MCP' section is brief policy justification, not padding. Minor over-explanation remains — e.g. the 'Shell escaping rule' teaches heredoc quoting Claude already knows, and the token-cost figures — so it sits at anchor 4 ('efficient; minor instances of over-explanation') rather than the fully lean anchor 5.

4 / 5

Actionability

Nearly every section is copy-paste-ready: complete 'gh pr create' with heredoc body, 'gh pr view --json ... --jq ...' filters, 'gh pr checks --json name,state,conclusion', 'gh pr merge <number-or-url> --squash --delete-branch', plus a per-error fix table. This matches anchor 5 ('fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

The 'Full PR creation workflow' gives a numbered, ordered sequence ('Always follow this order — never skip steps') with a real validation checkpoint (checking for an existing PR before creating one) and an error-handling table that acts as a feedback loop (auth error → gh auth login; branch not pushed → push first). It falls short of anchor 5 only because the destructive 'gh pr merge --squash --delete-branch' step says just 'when authorized' without requiring CI checks to be green first — a minor validation gap consistent with anchor 4.

4 / 5

Progressive Disclosure

The skill has no bundle files and organizes everything into clearly headed sections (workflow, core commands, conventions tables, error handling) that are easy to navigate — matching anchor 4's 'good structure; most content is appropriately placed'. It misses anchor 5 partly because at ~200 lines some material (e.g. the branch/title/body-template conventions) could live in a reference file, and there is duplication across the three PR-creation sections ('Full PR creation workflow', 'Create a PR (minimal form)', 'Capturing PR URL') plus repeated auth guidance between the 'Authentication' section and the error table.

4 / 5

Total

17

/

20

Passed

Description

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

A strong, specific description that names the tool, its domain, and four concrete capabilities, with an explicit preference boundary against GitHub MCP tools. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which leaves the 'when' only weakly implied.

Suggestions

Add an explicit trigger clause, e.g. 'Use when creating or managing pull requests, commenting on GitHub issues, or checking PR/CI status' — per the rubric, the missing 'when' caps completeness at 3.

Mention merging PRs and checking CI status in the capability list so the description covers what the body actually teaches ('minor gaps in coverage' currently holds specificity at 4).

Include natural synonyms like 'pull request' alongside 'PRs' to broaden trigger-term coverage toward anchor 5.

DimensionReasoningScore

Specificity

Quotes 'creating PRs, checking status, commenting, and capturing URLs' — several concrete, specific actions are named, with only minor gaps in coverage (merging PRs and checking CI are covered in the body but omitted here). It names the domain ('gh (GitHub CLI) for all GitHub operations') plus four concrete actions, matching the anchor 'Lists several specific actions; minor gaps' rather than the comprehensive 5 anchor.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance — the judging guidelines cap completeness at 3 for this. It matches anchor 3 ('clear what but when is missing or only weakly implied'); the 'when' is only implicitly 'whenever GitHub operations arise', not an explicit trigger phrase, which keeps it below anchor 4.

3 / 5

Trigger Term Quality

Includes natural terms users would say: 'GitHub', 'PRs', 'gh', 'GitHub CLI', 'commenting', 'status'. A few natural variants are missing — 'pull request' spelled out, 'merge', 'issues' — so it falls just below the 5 anchor's 'comprehensive coverage of natural terms including synonyms'.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche ('Use gh (GitHub CLI) for all GitHub operations... Prefer gh over GitHub MCP tools') with distinct, unambiguous triggers — the gh CLI is a specific tool and the MCP-preference boundary is explicit. This matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk'; it is more distinct than anchor 4's example, which lacks an explicit boundary.

5 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

whimzyLive/nightshift-ai

Path

plugins/sdlc/skills/gh-cli/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.