CtrlK
BlogDocsLog inGet started
Tessl Logo

nushell-usage

Essential patterns, idioms, and gotchas for writing Nushell code. Use when writing Nushell scripts, functions, or working with Nushell's type system, pipelines, and data structures. Complements plugin development knowledge with practical usage patterns.

79

1.02x
Quality

74%

Does it follow best practices?

Impact

85%

1.02x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./nushell-usage/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 strong, example-driven reference body: executable Nushell snippets with outputs, pitfalls marked ❌/✅, and a clean two-file split for advanced topics with well-signaled one-level-deep references. The main improvement is removing duplication — the where/row-condition content appears in two separate sections — and trimming basics like if/match and string interpolation.

DimensionReasoningScore

Conciseness

Mostly dense, high-signal code, but there is real tightening to do: the row-condition/where material is covered twice (in 'Iteration Patterns' lines ~213-220 and again across the full 'Row Conditions vs Closures' section), and sections on if/match expressions, string interpolation, and 'Closures capture environment' re-explain basics Claude already knows. This is more than anchor 4's 'minor instances of over-explanation' but well short of anchor 2's padded verbosity.

3 / 5

Actionability

Nearly every section is copy-paste-ready executable Nushell with expected outputs shown in comments (e.g. '"a,b,c" | split row "," # ["a", "b", "c"]', '[1 2 3 4] | reduce {|it, acc| $acc - $it} # ((1-2)-3)-4 = -8'), including explicit ❌/✅ wrong-vs-right pairs. Specific examples cover the common cases, matching the anchor-5 example's pattern.

5 / 5

Workflow Clarity

This is a reference/patterns skill, so the implicit workflow is 'find the pattern for the task at hand and apply it', and the topic-labeled sections, best-practices list, and a dedicated 'Debugging Techniques' section (describe, print-and-passthrough, timeit) make that unambiguous. It is not a 5 because there is no explicit sequencing or checkpoint guidance for multi-step tasks (e.g. the 'test incrementally' best practice is a one-liner with no concrete technique).

4 / 5

Progressive Disclosure

SKILL.md stays at the core-usage level and pushes advanced material to two real, one-level-deep bundle files, each clearly signaled with a description of its contents in the 'Advanced Topics' section ('references/advanced-patterns.md - Performance optimization, lazy evaluation, streaming...', 'references/type-system.md - Complete type system guide...'); both files exist and contain the promised material. No nesting or buried references.

5 / 5

Total

17

/

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 third-person 'Use when...' trigger clause scoped to a clearly distinct niche (Nushell). Its main weakness is the 'what' half: 'patterns, idioms, and gotchas' are category labels rather than named concrete capabilities, and it omits natural synonyms like 'nu' and '.nu' files.

Suggestions

Replace the generic 'Essential patterns, idioms, and gotchas' with 2-3 concrete capabilities, e.g. 'Write Nushell pipelines and custom commands with correct type signatures, handle records/tables/nulls, and avoid common Nushell pitfalls'.

Add natural trigger variations users actually type, such as 'nu' and '.nu' files, to the 'Use when...' clause.

Clarify or drop 'Complements plugin development knowledge' — it presumes a companion skill the reader may not know, slightly blurring which skill to pick.

DimensionReasoningScore

Specificity

Phrases like 'Essential patterns, idioms, and gotchas for writing Nushell code' name the domain clearly but use category nouns rather than concrete actions (contrast with anchor-5's 'extract text, fill forms, merge documents'). It lists areas of application ('type system, pipelines, and data structures') but only implies 1-2 actual actions, matching the anchor-3 example 'Processes PDF files and extracts content'.

3 / 5

Completeness

Both are present: 'what' via 'Essential patterns, idioms, and gotchas for writing Nushell code' and an explicit 'Use when writing Nushell scripts, functions, or working with Nushell's type system, pipelines, and data structures' trigger clause. Not a 5 because the 'what' is generic ('patterns, idioms, gotchas') rather than concrete capabilities, and the trigger phrases lack the specificity of the anchor-5 example; not a 3 because the 'when' is fully explicit rather than weakly implied.

4 / 5

Trigger Term Quality

'Nushell scripts', 'functions', 'type system', 'pipelines', 'data structures' are natural phrases a user would say, giving good keyword coverage. It misses common variations users actually use, such as the 'nu' shorthand and the '.nu' file extension, so it does not reach anchor 5's 'comprehensive coverage of natural terms including synonyms and file extensions'.

4 / 5

Distinctiveness Conflict Risk

'Nushell' is a highly specific niche with distinct triggers, but 'Complements plugin development knowledge with practical usage patterns' references a sibling skill without naming it, creating minor ambiguity about which skill applies when writing Nushell plugin code. Mostly distinct with minor overlap risk against a closely related Nushell skill, matching anchor 4.

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
YPares/agent-skills
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.