CtrlK
BlogDocsLog inGet started
Tessl Logo

windows-compatibility

Cross-platform path handling and command patterns

55

Quality

62%

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

Fix and improve this skill with Tessl

tessl review fix ./.copilot/skills/windows-compatibility/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with concrete, executable code and a well-sequenced commit workflow that includes a validation checkpoint. Its main weakness is mild redundancy between the Context and Patterns sections and a verbose PowerShell example that could be trimmed.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet-point patterns with concrete code, but the Context section restates the Patterns subsections and the full PowerShell staging block is long and workflow-specific, so it could be tightened rather than fully earning the lean/every-token-counts anchor.

2 / 3

Actionability

It provides fully executable guidance — the safeTimestamp() utility, `git diff --cached --quiet`, `git commit -F $msgFile`, `git rev-parse --show-toplevel`, and `path.join()` — plus a copy-paste-ready correct example and concrete incorrect counterexamples.

3 / 3

Workflow Clarity

The commit workflow is explicitly sequenced with a validation checkpoint: cd, stage explicit files, `git diff --cached --quiet` check, then conditional `git commit -F`, satisfying the clear-sequence-with-explicit-validation anchor and avoiding the destructive/batch cap.

3 / 3

Progressive Disclosure

No bundle files exist and the content is self-contained and appropriately organized into Context, Patterns (with subsections), Examples, and Anti-Patterns with no nested references, fitting well-organized single-level structure.

3 / 3

Total

11

/

12

Passed

Description

40%

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 identifies a domain but is abstract and action-free, lacking both concrete capabilities and an explicit use-when trigger clause. It is distinguishable only by its cross-platform framing and would benefit from named actions and trigger terms.

Suggestions

Replace noun-only phrasing with concrete verbs, e.g. "Sanitize Windows-illegal filenames, rewrite git commands for cross-platform safety, and normalize path separators."

Add an explicit trigger clause: "Use when writing file paths or git/shell commands that must run on Windows, macOS, and Linux."

Include the natural trigger terms users actually say ("Windows", "git", "filenames", "paths") instead of generic phrases like "command patterns".

DimensionReasoningScore

Specificity

The description "Cross-platform path handling and command patterns" uses only noun phrases and lists no concrete actions (no verbs like "sanitize", "convert", "stage"), matching the vague/abstract anchor rather than the domain-with-actions anchor at 2.

1 / 3

Completeness

It states a weak "what" (path handling, command patterns) but has no "Use when..." clause or explicit trigger guidance, so per the rubric cap completeness cannot exceed 2.

2 / 3

Trigger Term Quality

"cross-platform" and "path" are somewhat natural, but the phrase omits the terms a user would actually say ("Windows", "git", "filenames") and leans on jargon like "command patterns", fitting some-relevant-keywords-but-missing-variations.

2 / 3

Distinctiveness Conflict Risk

"Cross-platform path handling and command patterns" has a platform niche but is generic enough to overlap with general coding, git, or path utilities, fitting the somewhat-specific-but-could-overlap anchor.

2 / 3

Total

7

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
bradygaster/squad
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.