CtrlK
BlogDocsLog inGet started
Tessl Logo

simple-pr

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

60

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/simple-pr/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a tight, actionable, well-sequenced workflow with genuine validation gates and a fix-retry loop before committing. Its only weaknesses are cosmetic: a couple of filler sentences, a truncated license-header snippet, and no commit-message format example. This is a strong skill content body.

DimensionReasoningScore

Conciseness

The body is command-first and lean ("Run: `git status`", "Run: `git pull origin main`") with only minor over-explanation ("This ensures we're working from the latest code", "Review the staged changes to understand what the PR will contain"). Not 5 because those filler sentences and the truncated license-header block don't fully earn their tokens; not 3 because padding is incidental, not pervasive.

4 / 5

Actionability

Nearly every step gives an executable command (`git diff --cached`, `cargo clippy --workspace --all-features --tests`, `gh pr create --draft ...`), and branch naming includes concrete examples. Not 5 because the license-header snippet is truncated with "// ..." (not copy-paste ready) and step 4 gives no commit-message format example; not 3 because the guidance is real, executable, and covers the common path.

4 / 5

Workflow Clarity

A clear 8-step sequence with explicit validation checkpoints: abort conditions in step 1 (unstaged changes, wrong branch), user confirmation of the commit message in step 4, and a pre-PR check gate with a fix-and-retry feedback loop in step 6 ("run these checks and fix any failures"). Matches the anchor for explicit validation steps with error-recovery loops; nothing significant is missing.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear step sections and no external references needed (none exist in the bundle). Not 5 because the body is ~79 lines, above the under-50-line simple-skill exception, and project-specific detail like the full Apache license header is inlined where a small reference file would keep the main flow tighter; not 3 because nothing that clearly belongs in a separate file is inlined and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

61%Weight 40%Scale 1-5

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 states a clear, concrete capability with natural trigger terms, but omits any explicit "when to use" guidance, which both caps completeness and limits its discoverability. It is reasonably distinctive within the git-workflow space. Adding a "Use when..." clause and spelling out "pull request" would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks to create a PR/pull request from already-staged changes."

Enumerate 1-2 more concrete actions (e.g., "runs pre-PR checks, creates a branch, pushes, and opens a draft PR") to raise specificity from naming the domain to listing specific capabilities.

Include the synonym "pull request" alongside "PR" to improve natural keyword coverage for users who don't abbreviate.

DimensionReasoningScore

Specificity

"Create a simple PR from staged changes" and "auto-generated commit message" name the domain plus 1-2 concrete actions, but the description does not enumerate several specific actions (e.g., branch creation, running checks, pushing). Not 4 because coverage is limited to two actions; not 2 because the actions given are concrete rather than generic.

3 / 5

Completeness

It clearly answers "what" (creates a PR from staged changes with an auto-generated commit message) but has no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3. Not 4 because the "when" is entirely absent rather than merely implicit; not 2 because the "what" is clear and specific.

3 / 5

Trigger Term Quality

"PR", "staged changes", and "commit message" are natural phrases users would say when needing this skill. Not 5 because common variations like "pull request" (spelled out) and "GitHub" are missing; not 3 because the terms present are exactly what a user would naturally say, not just domain jargon.

4 / 5

Distinctiveness Conflict Risk

"staged changes" and "simple PR" carve a specific niche with minor overlap risk against general commit-message or PR-review skills. Not 5 because "PR" and "commit message" are shared trigger terms with adjacent git-workflow skills; not 3 because the staged-changes scoping is more distinctive than "works with document files"-level generality.

4 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

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