CtrlK
BlogDocsLog inGet started
Tessl Logo

nushell-plugin-builder

Guide for creating Nushell plugins in Rust using nu_plugin and nu_protocol crates. Use when users want to build custom Nushell commands, extend Nushell with new functionality, create data transformations, or integrate external tools/APIs into Nushell. Covers project setup, command implementation, streaming data, custom values, and testing.

87

1.20x
Quality

82%

Does it follow best practices?

Impact

95%

1.20x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

64%

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

This is a solid, actionable skill with comprehensive executable code examples covering the full Nushell plugin development lifecycle. Its main weaknesses are the lack of explicit validation checkpoints in workflows (especially around build/register steps) and some content organization issues where inline material overlaps with referenced files. The conciseness is generally good but could be tightened by removing explanatory text Claude doesn't need.

Suggestions

Add explicit validation checkpoints to the build/install workflow, e.g., verify cargo build succeeds before plugin add, check plugin use output, and include error recovery steps if registration fails.

Trim the Advanced Features section to brief pointers since detailed content is claimed to exist in references/advanced-features.md — avoid duplicating streaming and engine interaction examples inline.

DimensionReasoningScore

Conciseness

Generally efficient but includes some unnecessary explanations Claude would already know (e.g., explaining what MsgPackSerializer vs JsonSerializer are, explaining what plugins are in the overview). The serialization section and some command type descriptions could be tightened. However, most code examples are lean and purposeful.

2 / 3

Actionability

Provides fully executable Rust code with complete imports, a working main function, concrete cargo commands for building/installing, and specific examples for signatures, parameters, error handling, and common patterns. The code is copy-paste ready and covers the full lifecycle from project creation to testing.

3 / 3

Workflow Clarity

The Quick Start provides a clear 3-step sequence (create, implement, build/install), and the Development Workflow section shows iterative development steps. However, there are no explicit validation checkpoints — no verification that the plugin compiled correctly before registering, no error recovery guidance if 'plugin add' fails, and the reload workflow lacks validation between steps.

2 / 3

Progressive Disclosure

References to four separate reference files (plugin-protocol.md, advanced-features.md, examples.md, testing-debugging.md) and a template script are well-signaled and one level deep. However, no bundle files were provided, so these references cannot be verified as existing. The main file also includes substantial inline content (advanced features, engine interaction) that partially duplicates what the references claim to cover, suggesting suboptimal content splitting.

2 / 3

Total

9

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly defines a narrow, specific domain (Nushell plugin development in Rust), lists concrete capabilities, and includes an explicit 'Use when' clause with natural trigger terms. It covers both the technical specifics (crate names, Rust) and user-intent language (extend, build, integrate), making it easy for Claude to select appropriately.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: creating Nushell plugins in Rust, project setup, command implementation, streaming data, custom values, and testing. These are concrete, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (guide for creating Nushell plugins in Rust covering project setup, command implementation, streaming data, custom values, testing) and 'when' (explicit 'Use when' clause with multiple trigger scenarios like building custom commands, extending Nushell, creating data transformations, integrating external tools).

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'Nushell plugins', 'Rust', 'nu_plugin', 'nu_protocol', 'custom Nushell commands', 'extend Nushell', 'data transformations', 'integrate external tools/APIs'. Good coverage of both technical crate names and natural language terms.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche: Nushell plugin development specifically in Rust using specific crates (nu_plugin, nu_protocol). Very unlikely to conflict with other skills given the narrow domain.

3 / 3

Total

12

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

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.