CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

best-practice-research

[OMX] Bounded best-practice research wrapper using official/upstream evidence first

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/oh-my-codex/skills/best-practice-research/SKILL.md

The canonical home for this skill is best-practice-research in Yeachan-Heo/oh-my-codex

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 a well-structured, appropriately scoped instruction skill: clear activation/deactivation boundaries, concrete specialist routing, a sequenced workflow with stop conditions, and a copy-paste output template. Its main weakness is redundancy — the terminal stop/handoff rule is repeated across four sections — which is the only thing keeping conciseness below the top tier.

Suggestions

Consolidate the terminal/stop/handoff rule into one section (e.g. keep 'Stop Rules' and the Output Contract handoff, trimming the restatements in 'Purpose' and 'Terminal By Default').

Deduplicate the dependency-expert routing, which currently appears in both 'Do Not Activate When' and 'Specialist Routing'.

Turn the Source-Quality Rules into an explicit validate step in the Workflow (e.g. 're-verify material claims have source URLs and version/date context before synthesizing') to close the checkpoint gap.

DimensionReasoningScore

Conciseness

The body is mostly lean, assumes Claude's competence, and explains nothing Claude already knows, but the terminal/stop/handoff rule is restated four times (Purpose, 'Terminal By Default', the Output Contract handoff, and 'Stop Rules'), and dependency routing appears in both 'Do Not Activate When' and 'Specialist Routing'. This matches anchor 3 ('could be tightened') rather than 4 because the duplication is a noticeable share of an otherwise short document.

3 / 5

Actionability

For an instruction-only skill the guidance is concrete: an explicit specialist routing table (explore → researcher → dependency-expert), a five-step numbered workflow, and a copy-paste output contract template with named sections. It is not 5 because the template is placeholder-driven and invocation of the named specialists ($ralplan, $ultragoal, $team, executor) is assumed rather than specified.

4 / 5

Workflow Clarity

The Workflow section gives a clearly sequenced five-step process with an explicit stop condition ('Stop when the answer is grounded enough') and an error path ('otherwise report the exact blocker or specialist handoff needed'), plus upward-routing triggers. It falls short of anchor 5 because evidence-quality validation (step 5 / Source-Quality Rules) is stated as directives rather than an explicit validate-and-retry checkpoint loop.

4 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and none are needed; all content is appropriately in a single well-organized file with clear, navigable sections (Activate When, Do Not Activate When, Specialist Routing, Workflow, Output Contract, Stop Rules). Nothing is inlined that belongs in a separate file, so the well-organized single-file pattern earns the top anchor.

5 / 5

Total

16

/

20

Passed

Description

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

The description identifies a specific niche (bounded, official-evidence-first best-practice research) in lean third-person phrasing, but it omits any 'Use when...' trigger clause and enumerates no concrete actions, leaving both completeness and specificity in the middle of the scale. Natural trigger coverage is thin, and the "[OMX]" prefix is opaque to users.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks for best practices, recommended approach, current guidance, official recommendations, standards, or version-aware external behavior.'

Enumerate one or two concrete actions (e.g. 'gathers and cites official/upstream evidence, then hands off a source-backed recommendation') instead of the generic 'research wrapper'.

Drop or expand the opaque '[OMX]' prefix, which adds no trigger value for users.

DimensionReasoningScore

Specificity

The description names the domain ("best-practice research wrapper") but the only action is the generic verb "research" plus the method qualifier "using official/upstream evidence first" — comparable to the anchor 'Names the domain but actions are minimal or generic'. It does not reach 3 because no concrete capabilities (gather, cite, synthesize, hand off) are enumerated.

2 / 5

Completeness

The 'what' is reasonably clear (a bounded research wrapper preferring official/upstream evidence), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the 'when' is entirely absent rather than merely weak.

3 / 5

Trigger Term Quality

It includes relevant natural keywords like "best-practice" and "official/upstream evidence", but misses common variations users would say such as "recommended approach", "current guidance", "standards", "migration notes", or "best practices" (plural). Anchor 3 ('Some relevant keywords but missing common variations or synonyms') is the closest fit.

3 / 5

Distinctiveness Conflict Risk

The phrase "best-practice research wrapper using official/upstream evidence" carves out a somewhat specific niche, but without any when-clause it could overlap with a general research/documentation skill, and the opaque "[OMX]" prefix does nothing to distinguish triggers. Anchor 3 ('Somewhat specific but could still overlap with similar skills') fits best.

3 / 5

Total

11

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

Yeachan-Heo/oh-my-codex

Path

plugins/oh-my-codex/skills/best-practice-research/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.