CtrlK
BlogDocsLog inGet started
Tessl Logo

simple-pr

Create a simple PR from staged changes with an auto-generated commit message

72

1.67x
Quality

58%

Does it follow best practices?

Impact

99%

1.67x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/simple-pr/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
quickwit-oss/tantivy
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.