CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

submit

Open every pull request through this skill — invoke it the moment completed changes need to become a PR, instead of running `git push` or `gh pr create` yourself, and once per PR in a stack. Never open a PR by hand while this skill is installed — it owns the branch and commit shape (Conventional Commits), the pre-push checks, the draft PR body (what, why, how), the mandatory screenshots for anything rendered, and the CI gate with root-cause fixes. Also triggers on "/submit", "submit this", "open a PR", "create a pull request", "push this up", "get this reviewed".

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

A tightly authored, highly actionable workflow document: concrete commands in every phase, explicit exit conditions and a CI failure feedback loop, consent boundaries, and a well-timed reference table that keeps the body to a lean overview. The only weakness is external: the plugin-root paths (assets/writing.md, scripts/prose-lint.py) that the workflow depends on at three points are not resolvable within the skill's own bundle.

Suggestions

Inline the essential writing rules from ../../assets/writing.md (or copy the file into the skill's references/) so the commit/PR text guidance is reachable from the skill bundle itself, since it is required at both phase 2 and phase 5.

State the expected location or fallback for scripts/prose-lint.py (e.g., 'if absent, skip linting and say so') so the mandatory lint steps in phases 2 and 5 cannot dead-end when the plugin script is not installed.

DimensionReasoningScore

Conciseness

The body is lean and prescriptive throughout: it assumes Claude knows what PRs, CI, and Conventional Commits are and never explains them, spending its ~90 lines entirely on rules, commands, and exit conditions (e.g., 'Never declare success with checks in flight.'). The short intro and forge note ('use the forge's equivalent, such as `glab`') each earn their tokens; this matches the lean-and-efficient top anchor rather than the minor-trimming-warranted anchor below it.

5 / 5

Actionability

Nearly every phase gives copy-paste-ready commands: `touch "$(git rev-parse --git-dir)/swd-submit"`, `git log @{u}..HEAD`, `gh pr view --json number,title,body,state,isDraft,baseRefName`, `git push -u origin <branch>`, `gh pr create --draft`, `gh pr edit`, `gh pr checks`, and `prose-lint.py --commit`. Even branch naming is concrete ('`<author>-<slug>`: the git user's first name in lowercase'), and detail is correctly deferred to reference files at the phase where it is needed — matching the fully-executable top anchor.

5 / 5

Workflow Clarity

Phases 0-6 are strictly sequenced with an explicit sequencing rule ('Each phase meets its exit condition before the next one starts'), per-phase exit conditions, a re-entry rule for re-invocation, and an explicit CI feedback loop: 'On failure, read the failing logs, find the root cause, fix it, and re-enter at phase 3.' A 'Definition of done' checklist closes it out — matching the top anchor for explicit validation steps and error-recovery loops, which matters given the destructive/batch-adjacent operations (pushing, staging).

5 / 5

Progressive Disclosure

The references table with a 'Read at' timing column is exemplary signaling — each of the four references/ files exists in the bundle, is one level deep, and is loaded at a named phase. However, two frequently referenced paths, `../../assets/writing.md` (referenced in phases 2 and 5 and in the reference files) and `<plugin root>/scripts/prose-lint.py`, live outside the skill's directory and are absent from the provided bundle, so a reader following them from the bundle hits dead ends. This fits 'good structure... references mostly clear; minor organization gaps' rather than the flawless top anchor.

4 / 5

Total

19

/

20

Passed

Description

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

An exemplary description: third-person voice, comprehensive and specific capability list, explicit 'when' guidance reinforced with six natural trigger phrases, and a sharply defined niche that tells Claude when NOT to use it. No fluff or over-claims despite its length — every clause is load-bearing.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities across the whole domain: 'owns the branch and commit shape (Conventional Commits), the pre-push checks, the draft PR body (what, why, how), the mandatory screenshots for anything rendered, and the CI gate with root-cause fixes'. This is comprehensive coverage of multiple specific actions, matching the anchor for listing multiple specific concrete actions; it is above 'several specific actions with minor gaps' because nothing in the PR-submission workflow is left out.

5 / 5

Completeness

Both questions are answered explicitly: 'what' via the enumerated ownership list (branch/commit shape, checks, draft body, screenshots, CI gate) and 'when' via 'invoke it the moment completed changes need to become a PR... once per PR in a stack' plus the explicit trigger-phrase list. This matches the top anchor of clearly answering both with concrete trigger phrases; not score 4 because 'when' is stated three distinct ways rather than being merely adequate.

5 / 5

Trigger Term Quality

It lists six natural trigger phrases users would actually say: '"/submit", "submit this", "open a PR", "create a pull request", "push this up", "get this reviewed"', plus the situational trigger 'the moment completed changes need to become a PR'. Coverage spans the command form and common verb variants, matching the comprehensive-synonyms anchor; not score 4 because no commonly used phrasing for requesting a PR is conspicuously missing.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — opening PRs — and actively reduces conflict by stating it should be used 'instead of running `git push` or `gh pr create` yourself' and 'Never open a PR by hand while this skill is installed'. Triggers are specific to PR submission, so overlap risk with adjacent skills (planning, review, rebase) is minimal, matching the clear-niche anchor.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

korya/swd-skills

Path

skills/submit/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.