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 a 'Use when...' clause, which is critical for skill selection. 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 create a pull request from their current staged changes or asks for help submitting a PR with an auto-generated message.'
Include common trigger term variations such as 'pull request', 'git', 'push', 'branch', and 'open a PR' to improve matching.
Expand specificity by listing concrete actions, 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 what 'simple' entails. | 2 / 3 |
Completeness | Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and since the 'when' is entirely absent and the 'what' is only moderate, this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes natural terms like 'PR', 'staged changes', and 'commit message' that users might say, but misses common variations like 'pull request', 'git', 'push', 'branch', or 'merge request'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of PR creation + staged changes + auto-generated commit message is somewhat specific, but could overlap with general git/commit message skills or broader PR management skills due to lack of explicit scoping. | 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 simple PR from staged changes. The workflow includes appropriate validation checkpoints (checking branch, staged state, user confirmation). Minor verbosity in explanatory sentences that Claude doesn't need slightly reduces token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but includes some unnecessary explanation (e.g., 'This ensures we're working from the latest code' and 'Review the staged changes to understand what the PR will contain' are things Claude already knows). Could be tightened by removing explanatory sentences. | 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 variables clearly indicated. | 3 / 3 |
Workflow Clarity | Clear sequential steps with validation checkpoints: checks workspace state before proceeding (abort conditions for unstaged changes or wrong branch), requires user confirmation of commit message before proceeding, and has a logical flow from verification through to PR creation. | 3 / 3 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines with no need for external references, the content is well-organized with clear section headers for each step. No bundle files are needed for this straightforward workflow. | 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 | |
46b3fb9
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.