CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

emerging-techniques-moe-training

Train Mixture of Experts (MoE) models using DeepSpeed or HuggingFace. Use when training large-scale models with limited compute (5× cost reduction vs dense models), implementing sparse architectures like Mixtral 8x7B or DeepSeek-V3, or scaling model capacity without proportional compute increase. Covers MoE architectures, routing mechanisms, load balancing, expert parallelism, and inference optimization.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./cli-tool/components/skills/ai-research/emerging-techniques-moe-training/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is rich in executable, copy-paste-ready code and commands covering the main MoE training path, but it reads as a monolithic handbook rather than an overview: it duplicates its own examples, re-explains basics, and inlines detail that belongs in the existing reference files. Adding an explicit sequenced workflow with validation checkpoints and moving advanced material into the references would substantially improve it.

Suggestions

Deduplicate the near-identical MoELayer and MixtralMoEBlock implementations and the two overlapping DeepSpeed config/training-command blocks; keep one canonical example inline and move the full architecture implementations into references/architectures.md.

Add an explicit ordered workflow (install → verify DeepSpeed MoE support → configure ds_config → launch training → monitor expert load balance and eval metrics) with validation checkpoints and a validate/adjust/retry loop for load imbalance and instability.

Surface the reference files contextually within their matching sections (e.g., 'for more architectures see references/architectures.md' in the architecture section) instead of only in the terminal 'See Also' list, and trim the body sections that duplicate reference-file content.

DimensionReasoningScore

Conciseness

Most content is concrete code, but there is noticeable tightening to do: the basic MoELayer and MixtralMoEBlock are near-duplicate implementations, two nearly identical DeepSpeed launch-command blocks and two overlapping moe config JSONs appear, and a 'Core Concepts' section plus ASCII diagram re-explain routing/expert basics Claude already knows. It is not anchor 2 because the majority of tokens are directly useful rather than padded prose.

3 / 5

Actionability

The primary paths are copy-paste ready (complete MoELayer and MixtralMoEBlock classes, full DeepSpeed launch commands, complete JSON configs), but secondary snippets have minor gaps: the Top-2 routing snippet references an undefined expert_outputs variable and moe_inference calls a nonexistent model.load_expert() API. These minor gaps place it at anchor 4 rather than the fully-executable anchor 5.

4 / 5

Workflow Clarity

Content is organized in an implied sequence (Installation → Quick Start → Core Concepts → Training Configuration → Best Practices → Inference) but there is no explicit ordered workflow and no validation checkpoints for long training runs; the conditional tuning heuristics ('If load imbalance persists, increase aux loss') are implicit feedback loops rather than the explicit validate-then-proceed steps of anchor 4.

3 / 5

Progressive Disclosure

The three referenced files (references/architectures.md, training.md, inference.md) all exist and are one level deep, but they are surfaced only in a terminal 'See Also' section rather than signposted within the relevant sections, and the body inlines advanced material that mirrors them (full Mixtral architecture implementation, two training-config sections, an inference-optimization section). This matches anchor 3's 'content that should be separate is inline' better than anchor 4's mostly-appropriate placement.

3 / 5

Total

13

/

20

Passed

Description

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

This is a strong description: it states concrete capabilities with named frameworks and models, includes an explicit 'Use when' clause with specific trigger conditions, and uses natural terminology with both abbreviations and synonyms. The only weakness is that two of its trigger phrases are generic compute-efficiency language that slightly overlaps with general large-scale training skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with named tools and models ('Train Mixture of Experts (MoE) models using DeepSpeed or HuggingFace', 'implementing sparse architectures like Mixtral 8x7B or DeepSeek-V3') plus a quantified benefit ('5× cost reduction vs dense models'), giving comprehensive coverage rather than the minor gaps of anchor 4.

5 / 5

Completeness

It explicitly answers both questions: the 'what' ('Train Mixture of Experts (MoE) models using DeepSpeed or HuggingFace... Covers MoE architectures, routing mechanisms, load balancing, expert parallelism, and inference optimization') and the 'when' via an explicit 'Use when...' clause with three concrete trigger conditions, matching the anchor 5 pattern.

5 / 5

Trigger Term Quality

It covers natural terms a user would say including the abbreviation and full name ('MoE', 'Mixture of Experts'), concrete model names ('Mixtral 8x7B', 'DeepSeek-V3'), framework names ('DeepSpeed', 'HuggingFace'), and technical phrases ('sparse architectures', 'load balancing', 'expert parallelism'), which exceeds the 'a few natural terms missing' level of anchor 4.

5 / 5

Distinctiveness Conflict Risk

The MoE framing with named models gives a clear niche with distinct triggers, but 'training large-scale models with limited compute' and 'scaling model capacity without proportional compute increase' are generic efficiency triggers with minor overlap risk against general distributed-training or DeepSpeed skills, fitting anchor 4 rather than the minimal-conflict profile of anchor 5.

4 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (528 lines); consider splitting into references/ and linking

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

davila7/claude-code-templates

Path

cli-tool/components/skills/ai-research/emerging-techniques-moe-training/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.