Generate ethical, compliant, and patient-friendly recruitment advertisements for clinical trials.
39
37%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/patient-recruitment-ad-gen/SKILL.mdQuality
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.'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
73f6514
Table of Contents
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.