CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

irb-application-assistant

Assists researchers with Institutional Review Board (IRB) application tasks, including drafting informed consent documents, reviewing research protocols for compliance, generating application forms, and preparing submission checklists. Use when the user mentions IRB, Instituti...

Quality

76%

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 ./scientific-skills/Academic Writing/irb-application-assistant/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%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 IRB-specific core (Core Capabilities, Recommended Workflow with explicit validation checkpoints, Quality Checklist) is genuinely strong and executable in form. It is undermined by heavy template boilerplate, triplicated description text, duplicate/contradictory sections, and references plus a script that are missing from the bundle entirely.

Suggestions

Cut the duplicated template sections (repeat 'When to Use'/'Key Features' description pastes, 'Quick Check' vs 'Audit-Ready Commands', 'Output Requirements', 'Response Template', 'Input Validation', 'Dependencies') to roughly halve the file and keep only the IRB-specific workflow.

Ship the referenced bundle files (scripts/main.py, references/guide.md, references/examples/, references/audit-reference.md) or remove the references; currently every pointer is dangling, which collapses progressive disclosure and makes the documented commands non-executable.

Merge the two conflicting '## References' sections into one, remove the 'Implementation Details' filler cross-reference ('See ## Workflow above for related details'), and replace the machine-specific 'Example Usage' path with a portable one.

DimensionReasoningScore

Conciseness

The frontmatter description is pasted verbatim three times ('When to Use', 'Key Features', 'Scope-focused workflow aligned to:'), 'Quick Check' and 'Audit-Ready Commands' duplicate the same commands, there are two conflicting '## References' sections, and generic boilerplate ('Output Requirements', 'Response Template', 'Input Validation', 'Implementation Details: See ## Workflow above for related details') pads the file without adding IRB-specific value.

2 / 5

Actionability

Each of the four capabilities has a copy-paste-ready command with full flags (e.g. 'python scripts/main.py --task consent --protocol protocol.json --population "adults 18+" --risk-level minimal --output consent_form.docx'), but scripts/main.py is absent from the bundle, input files are placeholders, and 'Example Usage' hardcodes a machine-specific path ('20260318/scientific-skills/...'), so the commands cannot run as shipped.

4 / 5

Workflow Clarity

'Recommended Workflow' gives a clearly sequenced 6-step process with explicit validation checkpoints and feedback loops: 'If the compliance report flags ANY errors, resolve ALL flagged items and re-run --task compliance-check before proceeding' and 'review errors in validation_report.txt -> fix each issue -> re-run -> only proceed when the report shows zero blocking errors', plus a closing manual-review step.

5 / 5

Progressive Disclosure

Sections are clearly headed and a quick start exists, but every bundle pointer is dangling — references/guide.md, references/examples/, and references/audit-reference.md do not exist in the package — and two contradictory '## References' sections plus ~215 lines of inlined template boilerplate that belongs in reference files leave the overview/detail split broken.

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, specific, third-person description with a distinctive niche and concrete action list. Its main defect is that the text is literally truncated on disk, cutting the 'Use when the user mentions...' trigger list off mid-phrase.

Suggestions

Restore the full, untruncated 'Use when the user mentions...' clause so the trigger list is complete (e.g., include 'IRB, Institutional Review Board, research ethics, human subjects research, protocol review, informed consent').

Verify the description field is under any length limit and re-save it; the current file ends mid-word at 'Instituti...', which both weakens trigger matching and looks like a packaging error.

DimensionReasoningScore

Specificity

States four concrete third-person actions — 'drafting informed consent documents, reviewing research protocols for compliance, generating application forms, and preparing submission checklists' — giving comprehensive coverage of the domain, matching the multiple-specific-actions anchor.

5 / 5

Completeness

Both a clear 'what' (the four assisted tasks) and a 'when' ('Use when the user mentions IRB...') are present, but the 'when' clause is cut off mid-word, so the trigger guidance is incomplete rather than fully explicit.

4 / 5

Trigger Term Quality

Natural keywords like 'IRB', 'Institutional Review Board', 'informed consent', and 'submission checklists' are present, but the trigger clause is physically truncated mid-phrase ('Use when the user mentions IRB, Instituti...'), cutting off likely variations such as 'research ethics' or 'human subjects research'. Good coverage with a few natural terms missing, rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

IRB application assistance is a clear niche with distinct triggers (IRB, informed consent, protocol compliance, submission checklists) and minimal overlap risk with other skills.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 20 missing

Warning

Total

13

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Academic Writing/irb-application-assistant/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.