CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bin-scripts

Use when performing git operations, running Laravel/Composer commands, managing local dev sites, or killing processes on ports. Custom scripts in your PATH provide shortcuts for common workflows.

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 ./claude/skills/bin-scripts/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 command catalog: every script has exact copy-paste usage, prerequisites are documented, and prose stays lean. The main gap is safety workflow around destructive commands — git-abort is flagged destructive but has no verification step — which caps workflow clarity, and two sections carry dense inline detail that could move to reference files.

Suggestions

Add a verification step before destructive commands, e.g., under Undoing: 'Before `git abort`, run `git status` and confirm no untracked files are needed; aborting hard-resets and deletes untracked files.'

Deduplicate the cpanel section — the paragraph repeats the table's purpose cell verbatim; keep one.

Move the cpanel panel listing and the mux naming-rule details into reference files (e.g., references/cpanel.md, references/mux.md) to slim the main file below the simple-skill threshold.

DimensionReasoningScore

Conciseness

Lean tables of script/usage/purpose with almost no explanation of concepts Claude already knows. Not a 5: the cpanel entry duplicates its purpose cell nearly verbatim in the paragraph below ("React/Bun TUI for everything in ~/.claude/ — browse, search, mine, and clean"), and the mux naming-rules paragraph is a dense wall of detail that could be tightened. Not a 3: there is no padding or tutorial-style over-explanation anywhere.

4 / 5

Actionability

Every entry gives exact, copy-paste-ready usage with concrete arguments: `git save file1 file2 "message"`, `killport 3000`, `artisan migrate`, `cpx pint`, `mux tab <name> [path]`. Prerequisites are documented where they matter (git-issue's DOTFILES_GITHUB_USERNAME env var, cpanel's bun requirement, cpx's fallback chain). Not a 4: the commands cover the common cases with real argument examples, leaving no gaps an executor would hit.

5 / 5

Workflow Clarity

Sections are clearly organized by task category, but the skill documents destructive operations — `git-abort` is explicitly labeled "Hard reset + clean untracked files (destructive)" — with only a warning label and no verification or safety checkpoint (e.g., confirm a clean tree or stash before aborting). Per the rubric, a destructive/batch skill without validation steps is capped at 3, which overrides the simple-skill exception. Not a 2: the structure is coherent and each script's effect is unambiguous; the cap alone prevents a 4.

3 / 5

Progressive Disclosure

Well-organized sections (Committing, Undoing, History, Inspection, Syncing, Utilities, etc.) make this ~125-line catalog easy to navigate, and there are no bundle files to mismanage. Not a 5: the file exceeds the under-50-lines simple-skill exception and inlines reference-level detail — the cpanel panel-by-panel listing and the mux session-naming rules — that would fit naturally in reference files. Not a 3: nearly all content is appropriately placed and nothing is buried.

4 / 5

Total

16

/

20

Passed

Description

70%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 solid description with an explicit, multi-domain 'Use when' clause and natural trigger phrasing. Its main weaknesses are the generic 'what' half ('provide shortcuts for common workflows'), a second-person slip ('your PATH') that costs specificity, and the broad 'git operations' trigger that overlaps with any general git skill.

Suggestions

Rewrite in third person and make the 'what' concrete, e.g.: 'Runs custom bin scripts for git shortcuts (save, undo, sync), Laravel/Composer commands, local Caddy dev sites, port killing, and tmux session management.'

Replace the broad 'git operations' trigger with the specific subcommands users would actually say (commit/amend, undo/reset, rebase/sync, stash) to reduce overlap with general git skills.

Add the missing natural trigger terms for the body's second half: tmux sessions, process runner, and the Claude internals tooling.

DimensionReasoningScore

Specificity

"performing git operations, running Laravel/Composer commands, managing local dev sites, or killing processes on ports" lists several concrete capability areas that would merit a 4, but the second-person phrasing "Custom scripts in your PATH" triggers the third-person voice penalty, reducing the score by 1. Not a 2: it names multiple specific tools and actions, not a bare domain.

3 / 5

Completeness

The "when" is explicit with concrete triggers ("Use when performing git operations, running Laravel/Composer commands..."), and the "what" is stated ("Custom scripts in your PATH provide shortcuts for common workflows"), but the what is generic — it doesn't say what the shortcuts actually do. Not a 5: the what half lacks the concrete specificity of the anchor example; not a 3: the when clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: "git operations", "Laravel/Composer commands", "managing local dev sites", "killing processes on ports". Not a 5: it omits natural terms for much of the documented surface — no commit/undo/stash synonyms for the git half, and nothing for tmux/session/TUI workflows that fill half the body. Not a 3: coverage spans four domains with genuine user phrasing rather than jargon.

4 / 5

Distinctiveness Conflict Risk

The multi-domain bundle anchored by distinctive terms ("Laravel/Composer", "local dev sites", "killing processes on ports") carves a clear personal-toolchain niche. Minor overlap risk: the broad phrase "git operations" would also match a general git-commit or git-workflow skill. Not a 5 for that overlap; not a 3 because the overall trigger combination is much more specific than "Works with document files".

4 / 5

Total

15

/

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

joshmanders/dotfiles

Path

claude/skills/bin-scripts/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.