CtrlK
BlogDocsLog inGet started
Tessl Logo

windows-shell-commands

Running shell commands on this Windows checkout via the PowerShell and Bash tools, and passing multi-line or quoted arguments (commit messages, PR bodies, file content) without corruption. Use when running git or gh with multi-line or quoted input, writing a commit message or PR body from the command line, reaching for a heredoc or here-string, or after a message or body comes out wrapped in stray characters such as a leading and trailing `@`.

71

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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-constructed, highly actionable skill: correct copy-paste syntax for both shells, the exact corruption symptom that signals misuse, and a robust file-based fallback, all delivered without padding. The remaining gaps are minor — a slightly redundant closing summary and no explicit post-write verification step.

DimensionReasoningScore

Conciseness

The body is lean and operational — it assumes Claude knows what git/gh are and spends no tokens on background ('Prefer the PowerShell tool for shell commands on Windows, especially anything with quoting'; 'It runs Git Bash (POSIX sh), not cmd or PowerShell'). It falls short of the 5 anchor because the closing 'Rule of thumb' section largely restates guidance already given in the per-shell sections, and 'The trap: it is easy to type one shell's heredoc syntax into the other tool' duplicates the point made by the symptom section — minor trimming opportunities.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover the common cases: the PowerShell here-string `git commit -m @'...'@` block with the column-0 closing rule, the Bash `git commit -F - <<'EOF'` heredoc, `git commit -m "Subject" -m "Body paragraph."`, and `gh pr create --body-file path/to/body.md`. Each carries the critical literal-vs-expansion details (quoted delimiters, `@'` vs `@"`), matching the 5 anchor.

5 / 5

Workflow Clarity

The decision flow is clear and unambiguous — default to PowerShell, use Bash only for POSIX work, with a symptom-diagnosis section ('A commit message or PR body comes out wrapped in literal characters... a lone `@` line at the very top and bottom') acting as an error-recognition checkpoint and a most-robust fallback (write a file, pass `--body-file` / `-F`). It sits below the 5 anchor because there is no explicit verify step (e.g., checking the committed message before pushing) and no fix-retry loop, only symptom identification; it is clearly above the 3 anchor's 'checkpoints missing or implicit'.

4 / 5

Progressive Disclosure

Single self-contained file with well-organized, clearly headed sections (Default to PowerShell / Multi-line text / PR bodies and long content / Rule of thumb) and no external references — appropriate since the content is short and operational, so nothing is buried or nested. It misses the 5 anchor only because the body runs ~75 lines, above the under-50-line simple-skill exception, and the per-shell quoting recipes and the file-based fallback could plausibly live in a reference file if the skill grows.

4 / 5

Total

17

/

20

Passed

Description

91%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: third-person, concrete, and explicitly covering both what the skill does and when to use it, with natural trigger terms (git/gh, heredoc, here-string, commit message, PR body) plus a distinctive symptom-based trigger. Its only weakness is mild overlap risk with general commit-message/PR-body skills.

DimensionReasoningScore

Specificity

Quotes concrete actions: "Running shell commands on this Windows checkout via the PowerShell and Bash tools, and passing multi-line or quoted arguments (commit messages, PR bodies, file content) without corruption" — several specific actions with named tools and artifacts. It stops short of the 5 anchor's comprehensive coverage because the write-to-file approach and the corruption-diagnosis capability live only in the body, and the action list is scenario-framed rather than exhaustive.

4 / 5

Completeness

Explicitly answers both: what ("Running shell commands ... via the PowerShell and Bash tools, and passing multi-line or quoted arguments ... without corruption") and when ("Use when running git or gh with multi-line or quoted input, writing a commit message or PR body from the command line, reaching for a heredoc or here-string, or after a message or body comes out wrapped in stray characters"). Both are concrete and the 'when' clause lists four distinct trigger scenarios, matching the 5 anchor exactly; a 4 would require a weaker or less specific 'when'.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with synonyms: "git or gh", "multi-line or quoted input", "commit message or PR body", "heredoc or here-string", and the distinctive symptom trigger "wrapped in stray characters such as a leading and trailing `@`". Matches the 5 anchor (synonyms plus concrete variations) and exceeds the 4 anchor's 'a few natural terms missing' — nothing a user or Claude would naturally say here is absent.

5 / 5

Distinctiveness Conflict Risk

The Windows-shell-quoting niche ("this Windows checkout", PowerShell here-strings, Git Bash heredocs) is distinct, and the `@` symptom trigger is unambiguous. Minor overlap risk remains with generic git/PR-body skills via "writing a commit message or PR body from the command line", which could fire outside a Windows quoting context — 'mostly distinct; minor overlap risk' rather than the 5 anchor's minimal conflict risk.

4 / 5

Total

18

/

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
SRombauts/SQLiteCpp
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.