CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nwb-conversion

Converts neuroscience acquisition data to Neurodata Without Borders files with NeuroConv and PyNWB, preserves metadata and timebases, checks evidence-based clock alignment, and produces schema validation, NWB Inspector findings and round-trip checks. Use for NWB conversion and synchronization of planar single-channel two-photon TIFF imaging plus timestamped behavioral position CSV; this skill does not perform spike sorting or claim tested support for arbitrary acquisition formats.

75

Quality

94%

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

85%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.

An exceptionally rigorous and executable skill body: pinned environment, exact commands, explicit validation with rejection cases and error recovery, and a clean one-level reference structure verified against the actual bundle. Its one weakness is token efficiency — several provenance/testimony paragraphs (Zarr pin history, fixture test details, platform notes) read as evidence for human reviewers rather than instructions for the executing agent.

Suggestions

Move the extended Zarr-pin backstory (the codec_registry failure, macOS ARM64 run, and 'not claims about latest releases' caveat) into references/upstream-review.md, keeping only one inline sentence: 'Keep both Zarr pins even for HDF5-only conversions; see upstream-review.md.'

Trim the real-library test paragraph to the facts that change execution decisions (rejection cases, the TIFF (time,y,x) → NWB (time,x,y) mapping, and the retained Inspector orientation finding), and drop fixture tallies like 'eight non-square uint16 images' and 'four position samples'.

Convert the multi-sentence output/provenance notes in the Execute section into short bullets so the refusal behaviors (no overwrite of existing NWB/report, fresh path after failure) stand out for the executing agent.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows and is dense with domain-specific constraints, but it carries several testimonial passages that could be tightened or moved: the five-sentence Zarr-pin backstory ("the tested unconstrained Zarr 3.4.0 installation failed on `zarr.codec_registry`... ran the real conversion... on macOS ARM64... These are compatibility pins, not claims that..."), the fixture-level test description ("converts eight non-square uint16 images with irregular frame timing plus four position samples... recovers a known 1000-ppm clock drift"), and the platform note. This is more than the 'minor instances' of anchor 4, so anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') is the best fit; not anchor 2 because none of it is generic padding — it is all skill-specific.

3 / 5

Actionability

Guidance is fully executable: a copy-paste install command with exact pins, a copy-paste execution command (`nwb-env/bin/python scripts/convert_session.py /path/to/session.json --output /path/to/session.nwb`), a concrete config path (copy `assets/session-template.json`, replace synthetic values, contract in `references/input-contract.md`), and precise input requirements (finite strictly increasing timestamps, matching image/timestamp counts, one channel/plane declared). The common case is covered end-to-end.

5 / 5

Workflow Clarity

The six-step workflow is clearly sequenced (inventory → config → timebase → convert → validate → deliver) with explicit validation checkpoints: step 5 reads `.validation.json`, the script "exits with an error for schema failures", rejection cases are enumerated (duplicate timestamps, mismatched frame counts, absent clock evidence, nonlinear pulse disagreement, missing timezone), and error recovery is specified ("retain the error and use a fresh output path after correcting the cause"). Feedback loops for this batch/write operation are explicit, matching anchor 5; anchor 4's 'minor validation gaps' does not apply.

5 / 5

Progressive Disclosure

The body is a well-organized overview (supported-streams table, install, workflow, execute, references) that delegates details one level deep with clearly signaled links: input contract and pulse-pair variant to `references/input-contract.md`, pin rationale and interface checks to `references/upstream-review.md`, config shape to `assets/session-template.json`, execution to `scripts/convert_session.py`. All referenced bundle files exist and none nest further. Navigation is easy and the split is appropriate.

5 / 5

Total

18

/

20

Passed

Description

100%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 dense but unpadded description: concrete third-person capability statements, an explicit 'Use for' trigger clause naming the exact supported input streams, and explicit negative boundaries. It fully matches the top anchors on all four dimensions.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions: "Converts neuroscience acquisition data to Neurodata Without Borders files with NeuroConv and PyNWB", "preserves metadata and timebases", "checks evidence-based clock alignment", "produces schema validation, NWB Inspector findings and round-trip checks". Coverage is comprehensive across conversion, preservation, alignment and validation, matching the anchor-5 example's breadth rather than the minor-gaps anchor 4.

5 / 5

Completeness

Both questions are answered explicitly: the "what" is the full conversion/validation pipeline in third person, and the "when" is an explicit "Use for NWB conversion and synchronization of planar single-channel two-photon TIFF imaging plus timestamped behavioral position CSV" clause with concrete trigger phrases. A negative boundary ("does not perform spike sorting or claim tested support for arbitrary acquisition formats") further sharpens scope, so this clearly exceeds the anchor-4 'when could be more specific' case.

5 / 5

Trigger Term Quality

Natural trigger terms include "NWB conversion", "Neurodata Without Borders" (synonym), "two-photon TIFF imaging", "timestamped behavioral position CSV", "synchronization", plus format extensions (TIFF, CSV) and tool names (NeuroConv, PyNWB, NWB Inspector). These are the phrases a user with this need would actually say; not score 4 because no obvious natural variation within this niche is missing.

5 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (NWB conversion of planar single-channel two-photon TIFF plus position CSV) with tool-specific triggers (NeuroConv, PyNWB, NWB Inspector) and explicit exclusion of adjacent domains like spike sorting and arbitrary acquisition formats. Conflict risk with other skills is minimal; anchor 5 fits.

5 / 5

Total

20

/

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

K-Dense-AI/scientific-agent-skills

Path

skills/nwb-conversion/SKILL.md

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.