CtrlK
BlogDocsLog inGet started
Tessl Logo

patient-recruitment-ad-gen

Generate ethical, compliant, and patient-friendly recruitment advertisements for clinical trials.

39

Quality

37%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/patient-recruitment-ad-gen/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 clear and distinctive niche (clinical trial recruitment ads) with some useful qualifiers, but it lacks a 'Use when...' clause, which significantly hurts completeness. The trigger terms are reasonable but could be expanded with common user variations, and the specificity could be improved by listing more concrete sub-actions.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g., 'Use when the user asks to create a clinical trial ad, study recruitment flyer, participant recruitment materials, or IRB-compliant advertising copy.'

Expand trigger terms to include common variations like 'study ad', 'trial flyer', 'patient recruitment', 'enrollment materials', 'IRB-compliant ad', and 'participant outreach'.

List more specific concrete actions, e.g., 'Drafts IRB-compliant ad copy, formats recruitment flyers, includes eligibility criteria summaries, and adapts messaging for diverse patient populations.'

DimensionReasoningScore

Specificity

The description names the domain (clinical trial recruitment) and a specific action (generate recruitment advertisements), with qualifiers (ethical, compliant, patient-friendly), but doesn't list multiple concrete sub-actions like drafting IRB-compliant language, formatting for specific channels, or including eligibility criteria.

2 / 3

Completeness

The description answers 'what' (generate recruitment advertisements for clinical trials) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'recruitment advertisements', 'clinical trials', and 'patient-friendly', but misses common variations users might say such as 'patient recruitment', 'study ad', 'trial flyer', 'IRB', 'participant recruitment', or 'enrollment materials'.

2 / 3

Distinctiveness Conflict Risk

The description targets a very specific niche—clinical trial recruitment advertisements—which is unlikely to conflict with other skills. The combination of 'clinical trials', 'recruitment', and 'advertisements' creates a distinct trigger profile.

3 / 3

Total

8

/

12

Passed

Implementation

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill contains genuinely valuable domain-specific content (IRB/EC compliance requirements, prohibited content list, input parameters, output structure) but buries it under massive amounts of generic boilerplate that applies to any skill and wastes context window. The circular self-references ('See ## Prerequisites above'), duplicated workflow sections, and template sections (Risk Assessment, Security Checklist, Lifecycle Status) significantly dilute the useful content. Cutting the file by 60% while preserving the compliance and usage sections would dramatically improve it.

Suggestions

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template, Output Requirements, Input Validation) that don't contain domain-specific information—Claude already knows how to handle errors, validate inputs, and structure responses.

Consolidate the three overlapping workflow descriptions (Example Usage run plan, Workflow section, Implementation Details) into a single clear workflow with an explicit compliance validation checkpoint before finalizing the ad.

Remove circular self-references like 'See ## Prerequisites above' and 'See ## Usage above' which point to sections that themselves contain no useful content or point back.

Show a concrete example of generated output (a sample recruitment ad) so Claude knows exactly what the expected deliverable looks like, rather than just listing output section names.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Contains numerous boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that add no value for Claude. Multiple sections reference each other circularly ('See ## Prerequisites above', 'See ## Usage above'). The generic workflow, error handling, input validation, and response template sections are padded filler that Claude already knows how to do. The actual domain-specific content (compliance requirements, prohibited content) is buried among noise.

1 / 3

Actionability

The input parameters and CLI example are concrete and specific, and the compliance requirements provide genuinely useful domain knowledge. However, the script itself is not shown, the example uses a hardcoded absolute path, and much of the 'actionable' content is generic boilerplate (e.g., 'python -m py_compile scripts/main.py') rather than domain-specific executable guidance. The actual ad generation logic is opaque.

2 / 3

Workflow Clarity

There are multiple workflow sections that overlap and compete (Example Usage run plan, Workflow section, Implementation Details). The actual domain workflow—gathering inputs, checking compliance, generating the ad, validating against IRB requirements—is not clearly sequenced. There's no explicit validation checkpoint for compliance review before finalizing output, which is critical for a task involving regulatory compliance.

2 / 3

Progressive Disclosure

References to `references/` folder files (fda_guidance.md, ema_guidelines.md, etc.) are well-signaled and one level deep. However, no bundle files were provided, so these references may be dead links. The SKILL.md itself is monolithic with too much inline content that should be separated (boilerplate sections like Risk Assessment, Security Checklist, Evaluation Criteria could be removed entirely rather than split out).

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

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.