CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

61

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/sdlc/skills/gh-cli/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%Scale 1-5

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

This is a strong, highly actionable skill with excellent executable examples and a well-structured PR creation workflow with validation steps. Its main weakness is including substantial project-specific conventions (branch naming, PR title formats, per-phase body templates) inline, which bloats the file and could be better organized into separate reference files. The core gh CLI guidance is efficient and practical.

Suggestions

Move branch conventions, PR title conventions, and per-phase PR body templates into a separate CONVENTIONS.md or TEMPLATES.md file, referencing them from the main skill with one-line links.

Trim the 'Why gh over MCP' section to a single line like '## Why gh over MCP\ngh outputs only requested fields (~10-50 tokens) vs MCP full JSON payloads (~500-2000 tokens).'

DimensionReasoningScore

Conciseness

The core gh commands and workflow are efficient, but the branch conventions table, PR title conventions table, and PR body templates per phase add significant bulk that is project-specific configuration rather than gh CLI skill content. The 'Why gh over MCP' section is brief and justified. The shell escaping rule is useful but the CORRECT/WRONG example is slightly verbose. Overall, there's meaningful content but noticeable bloat from project-specific conventions.

3 / 5

Actionability

Nearly every section provides copy-paste ready bash commands with concrete examples. The full PR creation workflow is executable end-to-end with duplicate checking, the core commands use specific --json and --jq flags for minimal output, and the error handling table maps errors to specific fixes. This is highly actionable.

5 / 5

Workflow Clarity

The full PR creation workflow has explicit numbered steps with validation (check for existing PR before creating, push before PR creation). The 'Always follow this order — never skip steps' instruction is clear. Error handling covers the main failure modes with specific remediation. The duplicate-check step serves as a validation checkpoint before the destructive-ish operation of PR creation.

5 / 5

Progressive Disclosure

The content is a single monolithic file with no references to supporting files. The branch conventions, PR title conventions, and per-phase PR body templates could reasonably be split into a separate conventions or templates file. For a skill of this length (~150 lines of substantive content), the lack of any file splitting or cross-references is a minor organizational weakness, though the section headers provide reasonable internal navigation.

3 / 5

Total

16

/

20

Passed

Description

66%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 reasonably specific about what the skill does (GitHub operations via gh CLI) and helpfully distinguishes itself from MCP-based GitHub tools. Its main weakness is the lack of an explicit 'Use when...' clause, which would help Claude know precisely when to select this skill. Adding trigger phrases and a few more natural keywords would strengthen it.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to create pull requests, check CI status, comment on issues, or perform any GitHub operation.'

Include additional natural trigger terms and synonyms such as 'pull request', 'repo', 'repository', 'issues', 'merge', and 'review' to improve keyword coverage.

DimensionReasoningScore

Specificity

Lists several specific actions: creating PRs, checking status, commenting, and capturing URLs. Also mentions preferring gh over GitHub MCP tools. Minor gaps — doesn't mention issues, releases, or other gh capabilities — but good coverage of common operations.

4 / 5

Completeness

The 'what' is clear — use gh CLI for GitHub operations with specific examples. However, there is no explicit 'when' clause (e.g., 'Use when...'). The description implies when to use it but doesn't explicitly state trigger conditions, which caps this at 3 per the rubric guidelines.

3 / 5

Trigger Term Quality

Includes natural terms like 'GitHub', 'PRs', 'creating PRs', 'commenting', 'GitHub CLI', 'gh', and 'status'. Missing some common synonyms like 'pull request' (spelled out), 'merge', 'review', 'repo', or 'repository'.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche around GitHub CLI operations and explicitly differentiates from 'GitHub MCP tools', which helps distinguish it. Minor overlap risk with any general GitHub or git skill, but the gh CLI focus and the MCP differentiation reduce conflict.

4 / 5

Total

15

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
whimzyLive/nightshift-ai
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.