CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-commit-push

Use when the user asks to review finished uncommitted work, commit it and push it in one run. Not for planning or implementing, nor when the user stops before the push. Self-contained — execute the inlined steps directly, do NOT invoke other skills.

60

Quality

76%

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 ./plugins/flowai/skills/review-commit-push/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 delivers highly concrete, executable guidance with strong gating and validation logic, but it is a 430-line monolith padded with per-rule rationale and dated incident reports that belong in maintainer notes, plus a corrupted step 6/7 in the Push Phase that hurts coherence. Compression and splitting the JiT and CI protocols into reference files would materially raise both conciseness and progressive disclosure.

Suggestions

Fix the Push Phase's corrupted ending: step 7's text is duplicated inside step 6's 'Absent' parenthetical and then repeated as a malformed '7. **7. **Hand off to the next phase' heading with stray bold markers — deduplicate into one clean step 7.

Move dated incident records ('2026-09-02 and 2026-09-06...', 'measured 2026-08-19, one run in three...') and the long why-this-rule-exists narratives out of the runtime instructions into a maintainer reference file; keep one-line imperatives in the phase steps.

Split the JiT methodology (steps 2b, 3d, 3e, 8a, 8b, 11) and the CI-await polling protocol into reference files linked from SKILL.md, so the main file reads as the four-phase overview with gates and the heavy detail loads only when the subset applies.

DimensionReasoningScore

Conciseness

At ~430 lines the body is noticeably verbose: many rules carry multi-sentence justifications ('A scratch directory you made is yours to remove... is invisible to you and permanent to everyone else'), and it embeds dated incident records ('2026-09-02 and 2026-09-06: commit-doc-sync-gate... failed the same item both times', 'measured 2026-08-19, one run in three wrote to memory/') that are maintainer bookkeeping, not runtime instruction. It is not a 1 because it never explains generic concepts Claude already knows — the padding is project-specific rationale, not filler; it is not a 3 because the over-justification and dated-report content recurs across many sections rather than being isolated.

2 / 5

Actionability

Mostly executable throughout: exact commands ('git rev-parse --abbrev-ref --symbolic-full-name @{u}', 'git rev-list --left-right --count HEAD...@{u}', 'GIT_PAGER=cat git push [--set-upstream origin <CURRENT>]'), exact user-facing prompts to quote verbatim, exit-code semantics for CI polling, and a concrete report template. It falls short of fully copy-paste-ready because the Push Phase's step 6/7 structure is corrupted — step 7's full text is duplicated inside step 6's parenthetical and then repeated as a broken '7. **7. **Hand off...' heading — leaving the reader to reconcile two versions of the final step.

4 / 5

Workflow Clarity

The sequence is excellent: four strictly ordered phases, three explicit inter-phase gates, a first-match-wins verdict decision order, STOP semantics with recovery paths, and a closing verification checklist — matching the top anchor's validation/checklist/feedback-loop profile. The corrupted Push Phase step 6/7 duplication (step 7 inlined in step 6's parentheses and repeated with doubled numbering) is a real coherence defect that a 5 would not tolerate.

4 / 5

Progressive Disclosure

The body has clear structure (phase headers, numbered steps, a rules block) and is navigable, but it is a 430-line monolith with no bundle files at all (no references/, scripts/, or assets/ exist) — the JiT testing methodology (steps 2b, 3d, 3e, 8a, 8b, 11), the CI-await polling protocol, and the doc-sync mapping tables are content that clearly belongs in separate reference files inlined in SKILL.md. This matches the anchor for 'some structure, content that should be separate is inline'; it is not a 2 because section headers and consistent organization are present, and not a 4 because nothing at all is split out.

3 / 5

Total

13

/

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: concrete actions, explicit positive and negative triggers, and clear de-confliction with sibling skills. The only gap is that it undersells the composite's full scope (reflect phase, documentation sync, task-status flipping), which keeps specificity just short of the top anchor.

DimensionReasoningScore

Specificity

The description names the domain ('finished uncommitted work') and three concrete actions ('review', 'commit it', 'push it in one run'), matching the anchor for several specific actions with minor coverage gaps. It is not a 5 because the composite also performs a reflect phase and task-status/doc-sync handling that go unmentioned, and not a 3 because it lists more than 1-2 concrete actions.

4 / 5

Completeness

Both questions are answered explicitly: the 'what' is 'review finished uncommitted work, commit it and push it in one run' and the 'when' is a concrete 'Use when the user asks to...' clause plus negative triggers ('Not for planning or implementing, nor when the user stops before the push'). This matches the anchor that clearly answers both what and when with concrete trigger phrases; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases users would say are present: 'review', 'commit it and push it', 'uncommitted work'. A few common variations are missing ('uncommitted changes', 'dirty working tree', 'ship my work'), so it lands at good-but-not-comprehensive keyword coverage rather than the comprehensive-with-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (the review-commit-push tail of the SDLC cycle) and actively de-conflicts with sibling skills via exclusions ('Not for planning or implementing, nor when the user stops before the push') and the 'do NOT invoke other skills' boundary. Conflict risk is minimal — the main overlap candidates (review-only, commit-only, review-and-commit) are excluded by the explicit stop-before-push boundary.

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: 3 missing

Warning

Total

14

/

16

Passed

Repository

korchasa/flowai-plugins

Path

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