CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

v4-best-practices

Use when working with deepseek-v4-pro or deepseek-v4-flash in thinking mode on multi-step or plan-driven tasks. Provides rules to prevent stale references, unverified plan assumptions, and vague plan output.

Quality

85%

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

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

A lean, well-structured instruction-only skill where each rule is concrete, conditionally triggered, and justified by a specific failure class. The only notable gap is that rule 2's agent-spawn example is illustrative rather than executable and no rule specifies recovery behavior when verification fails.

DimensionReasoningScore

Conciseness

The body is 45 lines with no padding and no explanation of concepts Claude already knows; each rule is a two-line instruction, a compact bad/good example, and a one-line "Failure avoided" justification that ties the rule to an observable failure class, so every token earns its place.

5 / 5

Actionability

Rules 1 and 3 give concrete, executable guidance ("call `grep_files` or `read_file` to confirm it exists", good example "grep_files pattern=\"pub fn load_config\" → confirms src/config/mod.rs:42"), and the bad/good pairs make the target behavior unambiguous. Rule 2's agent block ("agent type=\"verifier\" model=\"deepseek-v4-flash\"") is a sketch rather than a literal command, which keeps it at anchor 4 instead of fully copy-paste-ready.

4 / 5

Workflow Clarity

Each rule states a precise trigger condition ("Before referencing a file path", "Before executing a plan that touches 3+ files", "In plan-mode output") and embeds a validation checkpoint (confirm existence, report mismatches), giving clear sequencing with most checkpoints present. The rules lack an explicit recovery loop for what to do when verification fails, so it sits below anchor 5.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no external references needed; content is split into a one-line purpose statement and three well-signaled numbered sections ("## 1. Verify references before writing", "## 2. Spawn a verifier sub-agent...", "## 3. Plan output must use confirmed path:line references"), which is well-organized structure for a skill of this size.

5 / 5

Total

18

/

20

Passed

Description

78%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 with an explicit 'Use when...' clause, concrete failure classes, and model-specific triggers that make it highly distinguishable. The main gap is that the 'what' describes what it prevents rather than what the rules actually instruct, which keeps completeness and specificity just below top marks.

DimensionReasoningScore

Specificity

"Provides rules to prevent stale references, unverified plan assumptions, and vague plan output" names three concrete failure classes the skill acts on, which goes beyond the 1-2 actions of anchor 3, though the actions themselves ("provides rules") stay generic rather than listing what the rules do.

4 / 5

Completeness

Both parts are present: "Use when working with deepseek-v4-pro or deepseek-v4-flash in thinking mode on multi-step or plan-driven tasks" answers when explicitly, and the second sentence answers what. The 'what' stays at the level of failure classes prevented rather than describing the actual rules (verify references, spawn verifier, use path:line), keeping it at anchor 4 rather than the fully concrete anchor 5.

4 / 5

Trigger Term Quality

"deepseek-v4-pro or deepseek-v4-flash in thinking mode on multi-step or plan-driven tasks" gives good natural keyword coverage — a user of those models would say these terms — but common variations like "planning", "agent mode", or "sub-agent" are absent, so it falls short of the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The triggers are tied to specific model names ("deepseek-v4-pro or deepseek-v4-flash in thinking mode") plus task shape, creating a clear niche with minimal overlap risk against generic planning or coding skills.

5 / 5

Total

17

/

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

Hmbown/Codewhale

Path

crates/tui/assets/skills/v4-best-practices/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.