CtrlK
BlogDocsLog inGet started
Tessl Logo

building-neural-networks

Execute this skill allows AI assistant to construct and configure neural network architectures using the neural-network-builder plugin. it should be used when the user requests the creation of a new neural network, modification of an existing one, or assistance... Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

36

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

20%

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

The body has reasonable section structure and a basic process sequence, but it is padded with generic boilerplate, contains zero executable code or concrete `build-nn` usage, and entirely ignores the bundled scripts and assets that would make it actionable. It describes the skill rather than instructing Claude how to perform it.

Suggestions

Replace the generic Instructions/Output/Resources/Prerequisites boilerplate with a concrete, copy-pasteable `build-nn` invocation and a sample configuration (layers, activations, training params) for at least one of the examples.

Reference and show how to use the bundled scripts (build_network.py, train_network.py, evaluate_network.py) and the assets/example_configurations/ directory instead of the filler 'Resources' list.

Add an explicit validation/checkpoint step in 'How It Works' (e.g. validate the generated config before executing the build, and what to do on failure) to lift workflow clarity.

DimensionReasoningScore

Conciseness

The body is padded with generic boilerplate that applies to any skill — 'Instructions' ('Invoke this skill when the trigger conditions are met'), 'Output' ('The skill produces structured output relevant to the task'), 'Resources' ('Project documentation / Related skills and commands'), and 'Prerequisites' ('Appropriate file access permissions') — plus descriptive prose restating what the skill does. This matches the 1 anchor (verbose, padded with unnecessary context); it is not 2 because the filler is substantial rather than occasional.

1 / 3

Actionability

There is no executable code or concrete command anywhere: 'How It Works' mentions 'Claude executes the `build-nn` command' but never shows invocation, arguments, or a configuration, and the Examples only narrate ('Generate the configuration for the `build-nn` command, specifying the layer types...') rather than showing one. This matches the 1 anchor (vague/abstract, describes rather than instructs).

1 / 3

Workflow Clarity

'How It Works' gives a real 3-step sequence (Analyze Requirements -> Generating Configuration -> Executing Build), so steps are not missing (not 1), but there are no validation checkpoints, no concrete commands at each step, and 'Error Handling' is generic ('Invalid input: Prompts for correction'). This matches the 2 anchor (sequence present but checkpoints missing/implicit).

2 / 3

Progressive Disclosure

The body is sectioned (Overview, How It Works, Examples, Best Practices) so it is not a monolithic wall (not 1), but it never references the actual bundle files that exist — scripts/build_network.py, train_network.py, evaluate_network.py, visualize_network.py and assets/example_configurations/, sample_datasets/ — despite 'Resources' being the natural place to link them. This matches the 2 anchor (some structure, references not clearly signaled).

2 / 3

Total

6

/

12

Passed

Description

50%

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 clear neural-network niche and attempts both a what and a when clause, but is undermined by broken grammar, a trailing incomplete clause, and generic filler trigger guidance instead of concrete user phrasings. It reads as templated rather than purpose-written.

Suggestions

Rewrite the description in clean third-person voice, e.g. 'Constructs and configures neural network architectures via the neural-network-builder plugin. Use when the user asks to build, modify, or layer a neural network (CNN, RNN, transformer) for a task.'

Replace the filler 'Use when appropriate context detected. Trigger with relevant phrases based on skill purpose' with concrete natural trigger terms users would actually say (e.g. 'build a neural network', 'design a CNN', 'add layers to a model').

Complete or remove the dangling 'or assistance...' so the when-clause is explicit and whole.

DimensionReasoningScore

Specificity

Names the neural-network domain and some actions ('construct and configure neural network architectures', 'creation of a new neural network, modification of an existing one') but is not comprehensive and is padded with the vague trailing 'or assistance...'. It does not reach 3 because the actions are abstract rather than a tight list of concrete capabilities, and not 1 because concrete domain and actions are present.

2 / 3

Completeness

It states both what ('construct and configure neural network architectures using the neural-network-builder plugin') and a when ('it should be used when the user requests the creation...'), so 'when' is not merely implied. However the when-clause trails off into 'assistance...' and the explicit trigger guidance is generic filler rather than concrete triggers, so it does not clearly satisfy the 3 anchor's 'explicit triggers'.

2 / 3

Trigger Term Quality

Some natural keywords appear ('new neural network', 'modification of an existing one') but coverage of variations is thin and the explicit trigger guidance is generic filler ('Use when appropriate context detected. Trigger with relevant phrases based on skill purpose') with no real user-facing phrasings. Not 1 because genuine natural terms exist; not 3 because common variations (e.g. 'deep learning model', 'build/train a network') are absent and the trigger clause is boilerplate.

2 / 3

Distinctiveness Conflict Risk

The neural-network niche is fairly specific ('neural-network-builder plugin', 'neural network architectures') but could overlap with general ML/model-building skills, and the generic 'Use when appropriate context detected' trigger weakens distinctiveness. Not 3 because triggers are not distinct enough; not 1 because the domain is clearly scoped to neural networks.

2 / 3

Total

8

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
jeremylongshore/claude-code-plugins-plus-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.