CtrlK
BlogDocsLog inGet started
Tessl Logo

veomni-new-op

Use this skill when adding a new optimized kernel or operator to veomni/ops/. Covers the full lifecycle: understanding VeOmni's ops architecture (KERNEL_REGISTRY + OpSlot dispatch, with a thin function-pointer shim for a few legacy global ops), implementing the kernel, registering it, adding tests, and documenting it. Trigger: 'add op', 'new kernel', 'add attention variant', 'new fused op', 'add triton kernel', 'optimize operator'.

76

Quality

95%

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

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

This is a high-quality, deeply project-specific skill body: it sequences the work into five phases with concrete registration code, exact paths, and real validation steps, and its Common Pitfalls section captures subtle failure modes (lazy factories, async wrapper coverage, NPU import guards). The main improvements are tightening the inline architecture/ directory-tree material — either trimming it or moving it to a reference file — and consolidating the repeated pointers to the design docs.

Suggestions

Move the VeOmni Ops Architecture section (directory tree plus the three-mechanism comparison) into a reference file (e.g. references/architecture.md) and keep a short decision summary in SKILL.md, improving both conciseness and progressive disclosure.

Consolidate the repeated pointers to docs/design/kernel_selection.md and unified_kernel_registry.md (currently referenced in Before You Start, Phase 1, and Phase 4) into one clearly signaled location.

Trim per-directory comments in the kernels/ tree to the few directories a new-op author will actually touch, cutting tokens without losing actionable context.

DimensionReasoningScore

Conciseness

The body is dense with project-specific knowledge Claude cannot know (registry mechanics, dispatch precedence, NPU guards, CI file quirks) and wastes almost no tokens on general concepts. Minor over-explanation remains — e.g., the full kernels/ subtree listing with per-directory comments and the repeated design-doc pointers across sections — keeping it at 'minor instances of over-explanation that could be trimmed' rather than the lean level-5 anchor.

4 / 5

Actionability

Guidance is copy-paste ready: a complete KernelSpec registration example ("KERNEL_REGISTRY.register(KernelSpec(name=..., op_name=..., variant=..., factory=..., hardware=...))"), the matching OpSlot declaration ("veomni_my_op = OpSlot(\"my_op\", \"standard\")"), concrete commands ("pytest tests/ops/ -v", "make quality"), exact file paths, and pointers to live examples (rotary/__init__.py, rms_norm/__init__.py). This matches 'Fully executable; copy-paste ready code or commands' covering the common cases.

5 / 5

Workflow Clarity

Five clearly sequenced phases (Design → Implement → Test → Document → Finalize) with explicit validation checkpoints: run "pytest tests/ops/ -v", then "make quality", verify "KERNEL_REGISTRY.dump()" and OpSlot rebinding, and run "/veomni-review" before the PR. The Common Pitfalls section supplies error-recovery guidance for each failure mode ('the variant is invisible to _bind_veomni_ops()... you'll silently exercise the wrong kernel'), matching the level-5 anchor with validation steps and error feedback.

5 / 5

Progressive Disclosure

Structure is good: well-labeled phases, a clear decision guide for the three dispatch mechanisms, and clearly signaled one-level-deep pointers to deeper material (docs/design/kernel_selection.md, unified_kernel_registry.md, veomni/ops/README.md, .agents/knowledge/). However, the ~70-line inline architecture overview and directory tree are content that could live in a separate reference file, which is the 'minor organization gaps' of level 4 rather than the well-split level-5 anchor.

4 / 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 strong description: it states a concrete multi-step lifecycle, scopes it to a specific directory and codebase, and closes with an explicit, well-chosen trigger list. The parenthetical architecture detail ("KERNEL_REGISTRY + OpSlot dispatch, with a thin function-pointer shim...") is slightly dense for a description and could be trimmed, but it does not introduce vagueness or over-claiming. It compares favorably to the good overall examples.

DimensionReasoningScore

Specificity

The description enumerates concrete lifecycle actions — "implementing the kernel, registering it, adding tests, and documenting it" — and anchors them to a specific target directory (veomni/ops/), which is comprehensive coverage for this skill's scope. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and exceeds the level-4 anchor, whose 'minor gaps in coverage' do not apply here.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' is the full lifecycle ("understanding VeOmni's ops architecture... implementing the kernel, registering it, adding tests, and documenting it") and the 'when' is a dedicated "Trigger:" clause with concrete phrases. This mirrors the level-5 anchor example structure exactly; level 4 ('when' could be more explicit) is beaten by the explicit quoted trigger list.

5 / 5

Trigger Term Quality

Explicit trigger phrases — "'add op', 'new kernel', 'add attention variant', 'new fused op', 'add triton kernel', 'optimize operator'" — cover the natural phrasings and synonyms (op/kernel/operator, triton/fused/attention variants) a developer would actually say. This matches the comprehensive-synonyms anchor; level 4 ('a few natural terms missing') would apply only if common variants were absent, and they are not.

5 / 5

Distinctiveness Conflict Risk

The niche is tightly scoped — "adding a new optimized kernel or operator to veomni/ops/" with project-specific mechanics (KERNEL_REGISTRY, OpSlot) — so it is clearly distinguishable from generic coding skills and unlikely to trigger for the wrong skill. It matches 'Clear niche with distinct triggers; minimal conflict risk'; level 4's 'minor overlap risk with closely related skills' is not evident.

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
ByteDance-Seed/VeOmni
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.