CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-workflows

Reusable git delivery workflows derived from local slash commands (commit, push, PR, release notes, GitHub Actions failure triage with worktree-based fixes, and isolating your own changes from a shared dirty workspace).

Quality

81%

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

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

An exceptionally actionable body: every workflow carries exact commands, explicit validation checkpoints, and error-recovery guidance for repo-specific failure modes, with clean one-level references. The main structural improvement would be moving the long scenario playbooks into reference files to keep SKILL.md lean.

Suggestions

Move the stacked-PR recovery and PR-metadata redaction playbooks into dedicated reference files (e.g. references/stacked-pr-recovery.md), leaving a one-line trigger summary in SKILL.md so simple invocations don't load them.

Trim version-specific evidence (package versions, line counts) to the durable lesson, or consolidate it into a gotchas reference, to reduce time-sensitive detail in the main file.

DimensionReasoningScore

Conciseness

The body is dense, repo-specific operational knowledge that assumes Claude's competence (no explanations of git or CI basics), with every section earning its place. Minor trims are possible — time-sensitive evidence details like "@cloudbase/manager-node 5.8.6 installed vs 5.8.8 locked" and "the same 46 lines" are version-specific detail not placed in a deprecated/old-patterns section. Not 5 for those minor instances; not 3 because there is no unnecessary concept explanation or padding.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover every inline workflow: "git merge-tree --write-tree <A's-branch> <B's-branch>", "gh api \"repos/<owner>/<repo>/actions/runs?branch=<branch>\" --jq ...", "GIT_SEQUENCE_EDITOR=true git rebase -i --autosquash <main-sha>", "node scripts/update-compat-baseline.mjs", plus concrete per-file conflict-resolution rules. Not 4 because there are no pseudocode steps or missing key details — even failure modes come with the exact command to judge them by.

5 / 5

Workflow Clarity

Multi-step processes are clearly numbered with explicit validation gates ("git diff --stat <old-sha> HEAD — it must be empty", "git apply --check <patch> before git apply <patch>", "git status --porcelain | grep -v '^M '` must come back empty", "Close with node scripts/diff-compat-config.mjs (Has blocking diff: NO)") and feedback loops for destructive operations (backup patch before git reset --hard, --force-with-lease, reopen-to-retrigger workflows). Not 4 because validation is explicit and verifiable at every risky step, including error-recovery guidance for misleading tool output.

5 / 5

Progressive Disclosure

Clear overview with well-signaled, verified, one-level-deep references ("references/source-commands.md" under "Source of truth", "references/command-catalog.md" under "Command mapping"), and both files exist. Not 5 because ~70 lines of scenario-specific playbooks (stacked-PR recovery, PR-metadata redaction) are inlined in SKILL.md rather than split into referenced files, so they are loaded even for a simple commit; not 3 because what is inline is clearly sectioned and the reference structure itself is clean.

4 / 5

Total

18

/

20

Passed

Description

66%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 concrete, capability-dense description that clearly states what the skill does, with distinctive niche triggers. Its main weakness is the complete absence of a "when to use" clause, which both caps completeness and leaves natural trigger phrasing underexploited.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks to commit, push, open a PR, cut a release, fix a failed GitHub Actions run, or separate their own edits from a shared dirty workspace."

Include the missing workflows from the body's own "When to use" list (publishing a version from main, IDE icon consistency check) so the description's coverage matches the skill's scope.

Add natural synonyms such as "pull request" and "version bump/publish" alongside "PR" and "release notes" to broaden trigger matching.

DimensionReasoningScore

Specificity

Lists six concrete actions ("commit, push, PR, release notes, GitHub Actions failure triage with worktree-based fixes, and isolating your own changes from a shared dirty workspace"), which is several specific actions with minor gaps. It is not 5 because two workflows the skill itself claims (publishing a version from main, IDE icon check) are absent from the description; it is well above 3 given the breadth and concreteness of the action list.

4 / 5

Completeness

The "what" is clear (reusable git delivery workflows with an enumerated capability list), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guideline. It is not 2 because the "what" is concrete and specific rather than vague.

3 / 5

Trigger Term Quality

Contains natural terms users would say — "commit", "push", "PR", "release notes", "GitHub Actions" — giving good keyword coverage. Not 5 because common synonyms and variations ("pull request", "version bump/publish", "merge", "changelog") are missing.

4 / 5

Distinctiveness Conflict Risk

The distinctive elements ("GitHub Actions failure triage with worktree-based fixes", "isolating your own changes from a shared dirty workspace") carve a clear niche with only minor overlap risk against closely related git/commit skills. Not 5 because the core commit/push/PR scope still overlaps generic git helper skills.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 10 missing

Warning

Total

15

/

16

Passed

Repository

TencentCloudBase/CloudBase-AI-Toolkit

Path

skills/git-workflows/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.