CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

push

Use when the user asks to push the current branch — confirms a first-time upstream and a diverged main, and refuses force pushes without explicit authorization. Not for committing or reviewing. Self-contained — execute the inlined steps directly.

68

Quality

86%

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

82%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 dense, highly actionable safety contract: exact commands, explicit user gates, exit-code-driven CI polling, and a thorough verification checklist. Its weaknesses are a corrupted step 6/step 7 boundary (duplicated and garbled markup that obscures the terminal flow) and structural redundancy between the Rules and Instructions sections.

Suggestions

Fix the corrupted markup at the step 6 'Absent' bullet and step 7 heading: step 7's full text is currently nested inline inside step 6's parenthetical continuation, and the heading renders as '7. **7. **TOTAL STOP**' — rewrite step 6 to end cleanly and restore step 7 as a standalone step.

Consolidate the heavy overlap between Rules (4 and 9) and Instructions (steps 3 and 6): keep the rules as one-line invariants and let the steps carry the procedural detail, trimming roughly a third of the duplicated force-refusal and CI-await prose.

Consider moving the CI-await contract (rule 9 + step 6, ~40 lines of polling, tunables, and investigate-handoff logic) into a references/ file linked from a short 'Await CI' pointer, which would cut the SKILL.md body roughly in half while keeping the core push flow front-and-center.

DimensionReasoningScore

Conciseness

There is no filler or re-teaching of known concepts — every line is contract detail (commands, exit codes, exact user-facing strings). However, redundancy is noticeable: Rule 4 restates Step 3 at length, Rule 9 restates Step 6, and the duplicated step 6/step 7 text wastes tokens. This sits between anchors 3 and 4; the repetition is deliberate safety emphasis rather than unnecessary explanation, so anchor 4 fits best.

4 / 5

Actionability

Fully executable guidance throughout: exact commands ('git rev-parse --abbrev-ref HEAD', 'git rev-list --left-right --count HEAD...@{u}', 'export SHA=$(git rev-parse HEAD)'), exact quoted user prompts, explicit exit-code semantics (0/1/2/other) for the CI status command, and a computable cap formula ('ITER_CAP = max(1, ceil(<budget> / <poll interval>))'). Copy-paste ready and covering the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced with explicit validation checkpoints (post-push verification that @{u} equals HEAD, the CI poll loop with terminal-state handling, and a full verification checklist with feedback paths for every failure mode). Two genuine defects hold it below anchor 5: step 6's 'Absent' bullet embeds the entire step 7 text inside a broken parenthetical continuation (lines 70-71), and step 7's heading is mangled as '7. **7. **TOTAL STOP**' with unbalanced bold markers (lines 98-99), making the terminal flow ambiguous on a first read.

4 / 5

Progressive Disclosure

A single self-contained file, well-sectioned (Overview/Context/Rules/Instructions/Verification), with no bundle files and no buried or nested references — consistent with its declared 'Self-contained' design. It exceeds the 50-line simple-skill exception at ~117 lines, and the CI-await subsection (~40 lines of polling and handoff logic) is substantial enough that it could plausibly live in a separate reference file, which is the minor organization gap that fits anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

87%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: explicit 'Use when...' trigger, concrete safety-oriented capabilities, and explicit out-of-scope boundaries. Its only weakness is moderate coverage of what the skill actually does — the post-push verification and CI-await halves of the contract are invisible to a reader of the description alone.

DimensionReasoningScore

Specificity

The description names the domain and several concrete behaviors — 'confirms a first-time upstream', 'a diverged main', 'refuses force pushes without explicit authorization', plus explicit exclusions ('Not for committing or reviewing'). It falls short of anchor 5 because real capabilities of the skill (target-branch check, post-push verification, CI await) are omitted, but it lists more than 1-2 actions, fitting the 'several specific actions with minor gaps' anchor.

4 / 5

Completeness

It explicitly answers both questions: what it does ('confirms a first-time upstream and a diverged main, and refuses force pushes without explicit authorization') and when to use it ('Use when the user asks to push the current branch'), with concrete trigger phrases and explicit scope boundaries. This matches the anchor-5 example structure directly.

5 / 5

Trigger Term Quality

'Use when the user asks to push the current branch' is the natural phrase a user would say, and 'committing'/'reviewing' serve as useful negative triggers. Natural synonyms users might also say ('publish', 'sync', 'origin', 'upload') are absent, so it fits anchor 4 (good coverage, a few natural terms missing) rather than 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (safe git push with authorization gates) with distinct triggers, and 'Not for committing or reviewing' explicitly disambiguates it from adjacent commit-message and code-review skills. Conflict risk is minimal, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

korchasa/flowai-plugins

Path

plugins/flowai/skills/push/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.