CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-review

Get a deep critical review of research from a fresh Codex agent or a selected Gemini, Grok, or Claude Code reviewer. Use when user says "review my research", "help me review", "get external review", or wants critical feedback on research ideas, papers, or experimental results.

Quality

78%

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 ./skills/skills-codex/research-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 skill is a genuinely actionable multi-round review workflow with copy-paste-ready call templates, explicit convergence criteria, and good error handling for unavailable reviewers. Its main defects are threefold: all external file references are dangling (none exist in the bundle), the body carries duplicated prompt/rule content across three sections, and key execution details are delegated to files that are not present.

Suggestions

Progressive disclosure: ship or fix the referenced files (reviewer-backends.md, review-tracing.md, output-composition.md, reviewer-routing.md, reviewer_route.py) or inline the load-bearing rules they carry; currently every reference is a dead end.

Conciseness: merge the trailing 'Prompt Templates' and 'Key Rules' sections into the workflow steps they duplicate, and trim the embedded Step 2 scope-limits passage to the few operative rules.

Actionability: specify the MCP-route tool names and either include reviewer_route.py with its expected arguments or replace the script invocation with inline resolution steps.

DimensionReasoningScore

Conciseness

The body avoids known-concept padding and templates are operational, but the dense 'Codex assurance' blockquote, the ~20-line philosophical scope-limits passage embedded in the Step 2 prompt, and the trailing 'Prompt Templates' and 'Key Rules' sections that substantially duplicate the inline Step 2-3 prompts could all be tightened or merged. This is 'mostly efficient but includes some unnecessary explanation or could be tightened' (anchor 3), not 4 because the duplication across sections is more than minor.

3 / 5

Actionability

Concrete copy-paste-ready templates are given for the first call (spawn_agent with model gpt-6-astra, reasoning_effort ultra) and continuation (send_input with saved session id), plus explicit follow-up patterns and deliverable templates covering common cases. It is not 5 because route resolution depends on a reviewer_route.py script that does not exist in the bundle and MCP-route tool names are left unspecified ('use their own first/reply tools'), leaving minor execution gaps.

4 / 5

Workflow Clarity

The 6-step sequence is clear, with prerequisites including explicit unavailable/BLOCKED handling, per-round feedback ('focus on whether the revision actually fixed them'), explicit convergence criteria in Step 4, and Step 6 verification (check completion and file coverage before a verdict). It is not 5 because mid-round error recovery (e.g., unusable or off-topic reviewer output) is not addressed and the verification procedure itself is delegated to a missing external file.

4 / 5

Progressive Disclosure

The body is well organized with clear section headers and clearly signaled one-level-deep references, but every referenced path (../shared-references/reviewer-backends.md, ../shared-references/review-tracing.md, ../shared-references/output-composition.md, reviewer-routing.md, and the reviewer_route.py script) is absent from the bundle, so the disclosure chain is broken and load-bearing rules (routing contract, tracing, composition) cannot actually be reached. Good in-body structure is undermined by wholly dangling references, landing between anchors 3 and 4, closer to 3 given the guideline to score against the actual bundle structure.

3 / 5

Total

14

/

20

Passed

Description

83%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 that clearly states what the skill does and when to use it, with natural quoted trigger phrases and a distinct research-review niche. The only weaknesses are moderate: it undersells the skill's concrete capabilities and misses a few natural synonyms (critique, draft, manuscript).

DimensionReasoningScore

Specificity

The description names a concrete deliverable ('Get a deep critical review of research'), the mechanism ('fresh Codex agent or a selected Gemini, Grok, or Claude Code reviewer'), and multiple objects ('research ideas, papers, or experimental results'). It lists several specifics but stops short of enumerating the distinct capabilities the body actually offers (experiment design, mock reviews, claims matrices), matching anchor 4 rather than 5.

4 / 5

Completeness

It explicitly answers both 'what' (obtain a deep critical research review from an external reviewer) and 'when' ('Use when user says "review my research"...') with concrete quoted trigger phrases, which matches the anchor-5 example exactly; it is not 4 because the 'when' clause is fully explicit rather than merely adequate.

5 / 5

Trigger Term Quality

It quotes natural user phrasings ('review my research', 'help me review', 'get external review', 'critical feedback on research ideas, papers, or experimental results') with good keyword coverage, but misses common synonyms such as 'critique', 'review my draft', or 'manuscript', matching anchor 4 (good coverage, a few natural terms missing) rather than 5.

4 / 5

Distinctiveness Conflict Risk

The external-research-review niche with quoted triggers is clearly distinguishable from most skills, though 'help me review' and 'critical feedback' create minor overlap risk with general code-review or feedback skills, matching anchor 4; it is not 5 because that overlap risk is real, and not 3 because the research-domain scoping is explicit.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/skills-codex/research-review/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.