CtrlK
BlogDocsLog inGet started
Tessl Logo

push

Push current branch changes to origin and create or update the corresponding pull request; use when asked to push, publish updates, or create pull request.

66

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./.codex/skills/push/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 well-structured, highly actionable workflow with explicit validation gates and error-recovery loops, and no bundle-file bloat. Its main cost is redundancy: the push-failure policy appears in three places (Steps, Commands comments, Notes) and Goals duplicates the description, which inflates token usage without adding guidance.

Suggestions

Consolidate the push-failure policy into one place — keep the decision tree in step 4 and reduce the Notes section to a one-line pointer ("sync problems → `pull` skill; auth/permission errors → surface and stop") instead of restating it.

Drop or shrink the Goals section (it restates the frontmatter description) and fold Prerequisites into a single line, saving tokens without losing guidance.

Consider moving the repo-specific backend/frontend validation command blocks into a referenced file (e.g. references/validation.md) so the Commands section stays focused on the push/PR flow.

DimensionReasoningScore

Conciseness

The body triple-states the push-failure policy — in step 4 ("If push is not clean/rejected... run the `pull` skill... surface the exact error"), again as comments in the Commands block, and again in Notes ("Distinguish sync problems from remote auth/permission problems") — and the Goals section restates the frontmatter description. Not a 2 because there is no padding or explanation of concepts Claude already knows; not a 4 because the redundancy across Steps/Commands/Notes is more than a minor trim.

3 / 5

Actionability

The Commands section is largely executable: concrete validation gates ("ruff check app tests", "pytest tests/unit -v", "npm run typecheck"), "git push -u origin HEAD", and gh pr commands. Not a 5 because the PR-body writing path is only a commented example workflow ("open the template and draft body content") and `pr_title` is a placeholder rather than copy-paste-ready; not a 3 because nearly everything else is runnable as written.

4 / 5

Workflow Clarity

Steps 1-8 are clearly sequenced with explicit validation checkpoints (pre-push validation gates, step 7's placeholder check "rg -n '<!--|Fixes #$|TODO|TBD'") and a feedback loop for error recovery (rejected push → `pull` skill → re-validate → retry). Matches the 5 anchor; the 4 anchor's 'minor validation gaps' does not apply since both push and PR-body validation are explicit.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the single body is well-organized into Prerequisites/Goals/Related Skills/Steps/Commands/Notes with clear navigation. Not a 5 because at ~126 lines it exceeds the under-50-line simple-skill case and the repo-specific validation command block is long enough that it could live in a referenced file; not a 3 because structure is clean and nothing is buried.

4 / 5

Total

16

/

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 with explicit what and when clauses in third-person voice and natural trigger terms. Its only weaknesses are minor: a few missing trigger synonyms ("open a PR", "PR") and slight breadth in "publish updates" that could overlap neighboring git-workflow skills.

DimensionReasoningScore

Specificity

Lists several concrete third-person actions — "Push current branch changes to origin", "create or update the corresponding pull request" — covering the skill's core operations. Not a 5 because coverage stops at push/PR-create-update and omits other handled behavior (rejected-push recovery, PR body updating); not a 3 because more than 1-2 actions are named and they are specific.

4 / 5

Completeness

Explicitly answers both: what ("Push current branch changes to origin and create or update the corresponding pull request") and when ("use when asked to push, publish updates, or create pull request") with concrete trigger phrases. Clearly matches the 5 anchor; the 'when' clause is explicit, so the 4 anchor's 'could be more explicit' caveat does not apply.

5 / 5

Trigger Term Quality

"use when asked to push, publish updates, or create pull request" supplies natural phrases users would actually say. Not a 5 because common variations like "open a PR", "PR" (abbreviation), or "publish my branch" are missing; not a 3 because keyword coverage goes well beyond a single generic term.

4 / 5

Distinctiveness Conflict Risk

The push/PR-creation niche has distinct, targeted triggers unlikely to fire for unrelated skills. Not a 5 because "publish updates" is broad and there is minor overlap risk with closely related skills (e.g., a pull/sync or PR-review skill); not a 3 because the triggers are clearly tied to this skill's specific purpose.

4 / 5

Total

17

/

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
karanhudia/borg-ui
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.