odyssey4me/github
Create and manage GitHub issues, pull requests, workflows, and repositories using the gh CLI. Use when asked to open a PR, merge a pull request, check repo actions, list issues, create a branch, or manage GitHub projects.
94
Quality
94%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
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 an excellent skill description that follows best practices. It uses third person voice, lists specific capabilities with the tool being used (gh CLI), and provides explicit trigger guidance with natural user phrases. The description clearly distinguishes itself from general git operations by focusing on GitHub-specific features.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create and manage GitHub issues, pull requests, workflows, and repositories using the gh CLI' - covers issues, PRs, workflows, and repos with the specific tool (gh CLI). | 3 / 3 |
Completeness | Clearly answers both what ('Create and manage GitHub issues, pull requests, workflows, and repositories using the gh CLI') AND when ('Use when asked to open a PR, merge a pull request, check repo actions, list issues, create a branch, or manage GitHub projects'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'open a PR', 'merge a pull request', 'check repo actions', 'list issues', 'create a branch', 'manage GitHub projects' - these are exactly how users phrase GitHub-related requests. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on GitHub operations via gh CLI with distinct triggers like 'PR', 'pull request', 'repo actions', 'GitHub projects' - unlikely to conflict with general git or other version control skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%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 provides comprehensive, actionable guidance for GitHub CLI operations. Its main strengths are excellent actionability with executable commands and clear workflow examples with verification steps. The primary weakness is some redundancy between sections and a Summary that largely repeats earlier content, which could be trimmed for better token efficiency.
Suggestions
Remove or significantly trim the Summary section as it repeats the Quick start and core concepts already covered
Consider moving Configuration and Troubleshooting sections to a separate reference file to reduce main skill length
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy - the Summary section repeats information already covered, and both script usage and direct gh commands are listed separately with overlap. Some sections like Configuration and Troubleshooting could be trimmed or moved to references. | 2 / 3 |
Actionability | Excellent actionability with fully executable commands throughout. Every section provides copy-paste ready bash commands with concrete examples including specific flags, repo formats (OWNER/REPO), and issue/PR numbers. The examples section shows complete workflows. | 3 / 3 |
Workflow Clarity | Multi-step workflows are clearly sequenced with verification steps. The 'Daily PR Review' and 'Create Issue and Link PR' examples include explicit verification commands (e.g., 'Verify: note the issue number from output', 'Verify PR was created and linked'). The distinction between read (wrapper script) and write (direct gh) operations is clearly stated. | 3 / 3 |
Progressive Disclosure | Well-structured with clear navigation. Core content is in the main file with appropriate references to external files (permissions.md, common-workflows.md) and official documentation. The structure moves logically from prerequisites to basic usage to advanced features without deep nesting. | 3 / 3 |
Total | 11 / 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.
Install with Tessl CLI
npx tessl i odyssey4me/githubReviewed
Table of Contents