CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

open-a-pr

Open a PR, write or rewrite a PR description, "the PR body is too long", or check whether a PR description is readable. Use whenever a PR is created or its body is edited.

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a dense, high-signal instruction skill: a complete template, exact commands, and per-case rules with genuine validation feedback loops, and essentially no wasted tokens. The only structural improvement would be presenting the overall process (run spec → draft body → create PR) as one explicit ordered sequence and, if the skill grows, splitting the evidence/changelog rules into a referenced file.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: every line is a project-specific rule Claude could not infer (template shape, word budget, changelog-agent integration, evidence binding to commits), with zero explanation of concepts Claude already knows. The two-sentence opening frames the skill's philosophy rather than padding it, so it matches the top anchor rather than level 4.

5 / 5

Actionability

Fully executable guidance: a complete copy-paste PR template with per-section content rules, exact commands (`gh pr create --base dev --title "<type>(<scope>): <change>" --body-file /tmp/pr-body.md`, `gh workflow run pr-proof.yml --ref <branch> -f pr=<number>`), and a worked example of an Evidence line. Common cases (no spec changed, UI changes, rebase) are each covered with a specific instruction.

5 / 5

Workflow Clarity

Validation checkpoints and feedback loops are explicit — run the spec before opening, "Red evidence is fixed, not narrated: fix the spec or the code and rerun it", rerun after rebase, and the before-section consistency check — but the end-to-end sequence (run spec → write body → create/edit PR) is implied across sections rather than given as one explicit ordered workflow. This sits between the level 4 anchor (clear sequence, most checkpoints) and level 5 (fully explicit sequenced workflow with checklists).

4 / 5

Progressive Disclosure

A single well-sectioned file (The shape / Evidence / Leave out / Do it) with no bundle files and no content that clearly belongs in a separate file; the template must stay inline. It meets the level 4 anchor (good structure, content appropriately placed), but at ~90 lines with no external references or navigation pointers it does not demonstrate the well-signaled one-level-deep reference structure of level 5.

4 / 5

Total

18

/

20

Passed

Description

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

A strong description that pairs concrete, naturally-phrased actions with an explicit use-when clause, including a quoted user utterance as a trigger. The only weaknesses are the missing "pull request" synonym and the broad "a PR is created" trigger that slightly raises overlap risk with neighboring PR-workflow skills.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Open a PR", "write or rewrite a PR description", "check whether a PR description is readable" — with only minor gaps in coverage (e.g., title conventions are handled in the body but not named here). It is above level 3 because more than 1-2 specific actions are named, but below level 5 because coverage of the skill's full surface is not comprehensive.

4 / 5

Completeness

Explicitly answers both parts: the "what" is the list of concrete actions (open, write/rewrite, check readability), and the "when" is fully explicit with concrete triggers — "Use whenever a PR is created or its body is edited". Level 4 would require the when-clause to be less explicit, which is not the case here.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "PR", "PR description", "PR body", plus a verbatim user-style phrase "the PR body is too long" and edit-time triggers like "its body is edited". Not level 5 because the spelled-out synonym "pull request" never appears, which is a common way users phrase the request.

4 / 5

Distinctiveness Conflict Risk

The niche (PR body authoring/readability) is distinct with specific triggers, but "Use whenever a PR is created" is a broad event that could also fire for adjacent PR-workflow skills, leaving minor overlap risk. Not level 3, since the focus on the description/body itself is clearly differentiated.

4 / 5

Total

17

/

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, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

different-ai/openwork

Path

.opencode/skills/open-a-pr/SKILL.md

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.