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

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

DimensionReasoningScore

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.

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.