CtrlK
BlogDocsLog inGet started
Tessl Logo

study-objective-refiner

Refines broad, vague, or aspirational biomedical research objectives into clear, bounded, measurable, executable, and downstream-ready study objective statements. Always use this skill when a user has a general aim such as “explore a mechanism,” “study prognosis,” “investigate biomarkers,” or “look at treatment response,” but the objective is still too broad, non-operational, or too ambiguous to support protocol framing, design selection, analysis planning, or hypothesis design. Never assume that polished wording alone means the objective is actionable. Focus first on objective type, missing operational elements, scope discipline, and downstream-ready formulation.

65

Quality

82%

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

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.

A well-structured instructional skill: a clear 9-step workflow mapped to a concrete 10-section output format, with detailed rules correctly externalized to ten real, purpose-mapped reference files and explicit validation gates for output completeness. The main weakness is redundancy — 'Core Function,' 'Hard Rules,' 'What This Skill Should Not Do,' and 'Quality Standard' substantially restate one another and the Execution steps — which inflates token cost without adding guidance value. The absence of an inline worked example (input → refined objective) also leaves the common case implicit.

Suggestions

Collapse 'What This Skill Should Not Do' and 'Quality Standard' into 'Core Function' and the relevant Execution steps — these sections restate the same rules (no full protocol, no fake precision, confirmatory/exploratory separation) verbatim, and cutting them would remove roughly a third of the body without losing any guidance.

Add one inline worked example (a vague input objective like 'explore the mechanism of immune escape in colorectal cancer' plus its refined plain-language / protocol-ready / downstream-ready outputs) so the common case is demonstrated without opening the reference files.

Deduplicate Hard Rules 1-10 against the Execution steps by keeping them as a short checklist of true constraints (e.g., literature-integrity rules 11-13) and removing those that merely restate Steps 1-9.

DimensionReasoningScore

Conciseness

Per-line the body is efficient — no padding explaining concepts Claude already knows — but structurally it restates itself across sections: 'Core Function' items 1-10 duplicate the Execution steps 1-9, 'What This Skill Should Not Do' re-lists the not-rules already given in 'Core Function' ("write a full protocol," "force confirmatory wording," fake precision), and 'Quality Standard' restates the Mandatory Output Structure's purpose, and Hard Rules overlap both. This matches anchor 3 ('mostly efficient but could be tightened') rather than anchor 2, since every line is operational directive rather than unnecessary explanation, but roughly a third of the ~290 lines is redundancy that could be cut without loss.

3 / 5

Actionability

As an instruction-only skill it gives concrete, specific guidance: Step 3 lists the exact elements to audit ("target population or system, exposure / biomarker / intervention, outcome or readout, comparison, time horizon, context"), Step 6 mandates three named output versions, and Sections A-J define a concrete deliverable. It falls short of anchor 5 only because there is no inline worked example (vague input objective → refined output) covering the common cases — that detail is deferred to references — so it sits at 'mostly executable guidance with minor gaps.'

4 / 5

Workflow Clarity

The 9-step Execution sequence is clearly ordered and explicitly mapped to output sections A-J via the Reference Module Integration table, and there are validation gates: "If any output section is generated without using its corresponding reference module, the output should be treated as incomplete," plus Step 8's measurability/executability assessment and Hard Rule 14's completeness test. It is not anchor 5 because there is no explicit error-recovery feedback loop (e.g., what to do when Step 8 finds the objective still non-executable — revision is only implied), which keeps it at 'clear sequence with most checkpoints present.'

4 / 5

Progressive Disclosure

All 10 referenced files exist in references/ and each is individually signaled with a one-level-deep, purpose-bound mapping: "references/objective-type-taxonomy.md → use when classifying the dominant objective type in Section B," with every other module tied to a specific section or task. Content is appropriately split — the operational detail lives in the reference modules while SKILL.md holds the workflow — matching the anchor 5 pattern of a clear overview with well-signaled single-hop references and easy navigation.

5 / 5

Total

16

/

20

Passed

Description

87%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 clearly states what the skill does and gives an explicit, natural-language 'use when' clause with quoted trigger phrases users would realistically say. Third person is used throughout, and the boundary against protocol/hypothesis/design work is drawn explicitly. The only weaknesses are mild: trigger synonym coverage could be broader and the capability list is one core action rather than several distinct actions.

DimensionReasoningScore

Specificity

The description names the domain ("biomedical research objectives") and specific transformation actions with concrete output qualities: "Refines broad, vague, or aspirational... into clear, bounded, measurable, executable, and downstream-ready study objective statements," plus focus areas "objective type, missing operational elements, scope discipline." It lists several specific actions but is centered on one core verb (refine), leaving minor coverage gaps versus the comprehensive multi-action anchor 5 example.

4 / 5

Completeness

Both questions are explicitly answered: the "what" ("Refines broad, vague, or aspirational biomedical research objectives into clear, bounded, measurable, executable... study objective statements") and an explicit "when" clause with concrete trigger phrases ("Always use this skill when a user has a general aim such as..."). This matches the anchor 5 example pattern of what + 'Use when...' with concrete triggers, so it is not the score-4 case where 'when' is only loosely specified.

5 / 5

Trigger Term Quality

It quotes natural user phrasings users would actually say: "explore a mechanism," "study prognosis," "investigate biomarkers," "look at treatment response," plus state terms "too broad, non-operational, or too ambiguous." Good keyword coverage, though a few natural variations (e.g., "narrow my aim," "sharpen my research question," "make my objective measurable") are missing, so it falls just short of the comprehensive-synonym anchor 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (objective-level refinement before design) and explicitly delineates adjacent territories — "protocol framing, design selection, analysis planning, or hypothesis design" — as downstream uses rather than this skill's job. Domain-specific trigger phrases (mechanism, prognosis, biomarker, treatment response) give it distinct triggers with minimal conflict risk, matching anchor 5.

5 / 5

Total

18

/

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
aipoch/medical-research-skills
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.