Create a simple PR from staged changes with an auto-generated commit message
72
58%
Does it follow best practices?
Impact
99%
1.67xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/simple-pr/SKILL.mdQuality
Discovery
32%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 conveys the core action (creating a PR from staged changes with an auto-generated commit message) but lacks an explicit 'Use when...' clause, which significantly hurts completeness. It also misses common trigger term variations like 'pull request' and 'git', and could be more specific about the concrete steps involved.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to quickly open a pull request from their staged git changes without manually writing a commit message.'
Include common trigger term variations such as 'pull request', 'git', 'push', 'branch', and 'open PR' to improve discoverability.
List more specific actions to increase specificity, e.g., 'Creates a new branch, commits staged changes with an auto-generated message, pushes to remote, and opens a pull request.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (PR creation) and a couple of actions (create PR, auto-generate commit message), but doesn't list multiple concrete actions comprehensively—e.g., no mention of branching, pushing, or specific PR platform details. | 2 / 3 |
Completeness | Describes what the skill does but has no explicit 'Use when...' clause or equivalent trigger guidance, and per the rubric a missing 'Use when' clause caps completeness at 2—but here the 'when' is entirely absent, warranting a 1. | 1 / 3 |
Trigger Term Quality | Includes natural terms like 'PR', 'staged changes', and 'commit message' which users might say, but misses common variations like 'pull request', 'git', 'push', 'branch', or 'merge request'. | 2 / 3 |
Distinctiveness Conflict Risk | Somewhat specific to PR creation with auto-generated commit messages, but could overlap with skills for commit message generation, git workflows, or general PR management since the scope isn't sharply delineated. | 2 / 3 |
Total | 7 / 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-structured, actionable skill that clearly guides Claude through creating a PR from staged changes. The workflow includes good validation checkpoints (checking branch, staged state, user confirmation). Minor verbosity in explanatory comments could be trimmed to improve token efficiency.
Suggestions
Remove explanatory phrases Claude already understands, such as 'This ensures we're working from the latest code' and 'Review the staged changes to understand what the PR will contain', to improve conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but has some unnecessary verbosity like 'This ensures we're working from the latest code' and 'Review the staged changes to understand what the PR will contain' which Claude already knows. Could be tightened into a more compact format. | 2 / 3 |
Actionability | Provides specific, executable git commands at each step with clear parameterization (e.g., branch naming convention, commit message format). Commands are copy-paste ready with placeholder syntax. | 3 / 3 |
Workflow Clarity | Clear sequential steps with explicit validation checkpoints: checking workspace state before proceeding, verifying branch is main, confirming commit message with user before committing. Includes abort conditions (unstaged changes, wrong branch) which serve as error handling. | 3 / 3 |
Progressive Disclosure | This is a simple, single-purpose skill under 50 lines with well-organized numbered sections. No need for external references, and the content is appropriately structured with clear headers for each step. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
3cd9011
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.