Pushes the current branch to the remote repository.
67
52%
Does it follow best practices?
Impact
93%
1.22xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/push/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description is concise and identifies a specific git operation but is too minimal to be effective for skill selection. It lacks a 'Use when...' clause, which is critical for Claude to know when to choose this skill. It also misses common trigger terms and variations users might use when requesting this action.
Suggestions
Add a 'Use when...' clause with explicit triggers, e.g., 'Use when the user asks to push code, sync with remote, git push, or upload changes to the remote repository.'
Include common trigger term variations such as 'git push', 'push to origin', 'push commits', 'upload to remote', 'sync upstream'.
Expand the capability description slightly to cover edge cases, e.g., 'Pushes the current branch to the remote repository, including setting upstream tracking and force-push options.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names a specific domain (git) and a single concrete action (pushes current branch to remote), but only describes one action rather than listing multiple specific capabilities. | 2 / 3 |
Completeness | Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also minimal, warranting a 1. | 1 / 3 |
Trigger Term Quality | Contains relevant keywords like 'push', 'branch', and 'remote repository' that users might say, but misses common variations like 'git push', 'upload code', 'sync remote', or 'origin'. | 2 / 3 |
Distinctiveness Conflict Risk | Somewhat specific to git push operations, but could overlap with broader git workflow skills or deployment skills. The narrow scope helps but the lack of explicit triggers reduces distinctiveness. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise and well-structured skill for a simple git push operation. Its main weaknesses are the lack of error handling for common push failures (rejected pushes, authentication issues, diverged branches) and the use of inline commands rather than proper code blocks for better actionability.
Suggestions
Add error handling guidance for common push failures (e.g., rejected push due to remote changes — suggest git pull --rebase first, then retry).
Format git commands in proper code blocks (```bash) for better readability and copy-paste readiness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient. Every line serves a purpose with no unnecessary explanation of what git push is or how git works. Assumes Claude's competence. | 3 / 3 |
Actionability | Provides specific commands (git status, git push, git push -u origin <branch-name>) but they are inline text rather than executable code blocks. The guidance is concrete but could be more copy-paste ready with proper code formatting. | 2 / 3 |
Workflow Clarity | Steps are clearly sequenced (check status, push, report), but there's no validation or error handling for common failure cases like authentication errors, rejected pushes due to remote changes, or diverged branches. A push operation can fail in several ways that warrant feedback loops. | 2 / 3 |
Progressive Disclosure | This is a simple, single-purpose skill under 50 lines. The content is well-organized with clear numbered steps and no need for external references. Appropriate structure for its scope. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
d93dc41
Table of Contents
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.