CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

endpoint-definition-designer

Designs primary, secondary, and exploratory endpoints for biomedical and clinical research protocols. Always use this skill when a user needs to translate study aims into operational endpoint definitions with event rules, assessment timing, composite logic, interpretability, and protocol-stage auditability. Focus on endpoint precision, feasibility, clinical meaning, ambiguity reduction, and implementation readiness rather than generic study design advice.

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

73%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, genuinely actionable instruction set with a clear sequenced workflow and verification/validation checkpoints. Its main weaknesses are repetition (the clarification gate stated five-plus times) and duplication of content that lives in the reference files, which cost both conciseness and disclosure efficiency.

Suggestions

State the clarification-before-drafting rule once — in the Clarification-First Rule section — and have other sections reference it instead of restating it; this alone would cut ~40 lines.

Remove the full A–J section list and the eight-step sequence from the body, replacing them with pointers to references/output-section-guidance.md and references/workflow-step-template.md, which already contain them verbatim.

Add one worked mini-example of a filled operationalization-table row (or one operational endpoint definition) to push actionability from mostly-executable to fully anchored.

DimensionReasoningScore

Conciseness

The body is directive and does not explain concepts Claude already knows, but it is padded by repetition: the clarification-before-drafting rule appears in five places (Reference Module Integration, Clarification-First Rule, Decision Logic Step 1, Core Function, Hard Rules #1, Formatting Expectations), the Sections A–J list is duplicated in references/output-section-guidance.md, and the negative-scope list appears twice ("This skill must not confuse", "What This Skill Should Not Do"). This fits "mostly efficient but includes some unnecessary explanation or could be tightened"; it is not score-2 material since the prose itself is dense rules rather than filler explanation.

3 / 5

Actionability

As an instruction-only skill, the guidance is concrete: exact output sections A–J with per-section content, an exact operationalization-table column list, a copy-paste out-of-scope redirect template, and three named draft-status labels. It falls short of score 5 because there is no worked example of a finished endpoint definition or a filled-in operationalization table to anchor the output format; the examples given are input prompts, not outputs.

4 / 5

Workflow Clarity

Decision Logic Steps 1–8 are clearly sequenced, each mapped to a specific reference module, with an explicit validation checkpoint up front (Step 1 clarification gate), error-recovery feedback loops (Sections H and I identify weak endpoints and remaining clarifications, Section J gates the draft status), and a checklist-style Hard Rules section. This matches the score-5 anchor including its feedback-loop and checklist criteria; the score-4 anchor would imply missing checkpoints, which are present.

5 / 5

Progressive Disclosure

The Reference Module Integration section maps each of the 10 existing reference files to specific output sections, and the references are verified one level deep with no nested pointers, fitting "well-signaled one-level-deep references". However, the body partially inlines reference content — the A–J section list duplicates references/output-section-guidance.md and the eight-step body duplicates references/workflow-step-template.md — which keeps it at "good structure; minor organization gaps" rather than the score-5 anchor's appropriately split content.

4 / 5

Total

16

/

20

Passed

Description

92%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 is specific, explicit about both what it does and when to use it, and clearly differentiated from generic study-design advice. Its only weakness is a few missing natural trigger synonyms (e.g., "outcome measures", "clinical trial endpoints").

Suggestions

Add common user-side synonyms such as "outcome measures" or "clinical trial endpoints" to the trigger phrase so users searching with those terms reliably match.

Trim the third sentence's abstract quality claims ("endpoint precision, feasibility, clinical meaning, ambiguity reduction, and implementation readiness") — it restates the second sentence and adds length without new triggers.

DimensionReasoningScore

Specificity

"Designs primary, secondary, and exploratory endpoints" plus "event rules, assessment timing, composite logic, interpretability, and protocol-stage auditability" names multiple concrete, specific actions with comprehensive coverage of the endpoint-design domain. It uses third-person voice ("Designs"), matching the top anchor rather than the score-4 anchor, which expects minor coverage gaps.

5 / 5

Completeness

The "what" is explicit (designs endpoint hierarchies, translates study aims into operational endpoint definitions) and the "when" is explicit: "Always use this skill when a user needs to translate study aims into operational endpoint definitions". Both are answered concretely, matching the score-5 anchor; the score-4 anchor would require a weaker or less explicit 'when' clause, which is not the case here.

5 / 5

Trigger Term Quality

Natural terms are present — "primary, secondary, and exploratory endpoints", "study aims", "endpoint definitions", "event rules", "assessment timing" — covering what a user would plausibly say. A few natural synonyms are missing (e.g., "outcome measures", "clinical trial", "protocol endpoints" as a standalone trigger), so it fits the "good keyword coverage; a few natural terms missing" anchor rather than the comprehensive score-5 example.

4 / 5

Distinctiveness Conflict Risk

"biomedical and clinical research protocols" with "rather than generic study design advice" carves out a clear niche with distinct triggers and minimal overlap risk with adjacent skills (e.g., general protocol-writing or statistics skills). It matches the "clear niche with distinct triggers" anchor, not the score-4 anchor that anticipates overlap with closely related skills.

5 / 5

Total

19

/

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

Path

awesome-med-research-skills/Protocol Design/endpoint-definition-designer/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.