CtrlK
BlogDocsLog inGet started
Tessl Logo

sop-writer

Write GCP-compliant standard operating procedures for laboratory, clinical, or research workflows; use when a reproducible SOP with roles, steps, and control points is required.

51

Quality

64%

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/Protocol Design/sop-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 has a clear section structure, real verification commands, and a properly linked one-level-deep reference file, but it is bloated with generic template boilerplate and never shows a complete, executable example of generating an SOP with the bundled script. Validation guidance exists but is fragmented across many sections instead of being woven into the workflow.

Suggestions

Add a copy-paste-ready example invocation, e.g. 'python scripts/main.py --name "Blood sample processing" --scope "Hematology lab" --responsibility "Lab technologist" --output sop.txt', to make the core task fully executable.

Cut or consolidate the boilerplate sections (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status, Returns/Output Requirements/Output Contract, Error Handling/Failure Handling) into one or two concise sections, removing the hard-coded review date.

Integrate validation checkpoints directly into the Workflow steps (e.g., run py_compile before execution, verify output contains required SOP sections after generation) instead of scattering them across separate sections.

DimensionReasoningScore

Conciseness

The ~190-line body is noticeably verbose with padded boilerplate sections that add little SOP-specific value: a Risk Assessment table, a nine-item Security Checklist, Evaluation Criteria with generic test cases, a Lifecycle Status section including a specific review date (2026-03-06), and three overlapping sections covering errors (Error Handling, Failure Handling, When Not to Use) plus three covering outputs (Returns, Output Requirements, Output Contract). It is not a 1 because it does not explain concepts Claude already knows and does contain some genuinely useful, tight sections (Quick Check, Audit-Ready Commands).

2 / 5

Actionability

There are real, executable commands ('python -m py_compile scripts/main.py', 'python scripts/main.py --help') and a Parameters section matching the script's actual flags, but the core task path is incomplete: no example invocation using --name/--scope/--responsibility, and the Example section ('Input: Blood sample processing / Output: Complete SOP...') is descriptive rather than executable. It is not a 4 because a user cannot copy-paste a working generation command from the body.

3 / 5

Workflow Clarity

The Workflow section lists a coherent 5-step sequence (confirm objective, validate scope, execute via script or reasoning path, return structured result, fallback on failure), and validation commands exist. However, checkpoints are scattered across separate sections (Quick Check, Quick Validation, Evaluation Criteria) rather than integrated as explicit validation steps within the workflow sequence, and the fallback path is described only abstractly. It is not a 4 because the sequence lacks inline validation checkpoints tied to each step.

3 / 5

Progressive Disclosure

The single reference (references/audit-reference.md) is real, one level deep, and clearly signaled with a link and purpose description, and scripts/main.py is referenced via concrete commands. However, the SKILL.md itself inlines substantial generic governance content (risk tables, security checklists, lifecycle metadata, response templates) that either belongs in a separate reference file or should be removed, leaving the overview cluttered. It is not a 4 because much of the inline content is not appropriately placed for an overview document.

3 / 5

Total

11

/

20

Passed

Description

70%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 solid description that clearly states what the skill does and when to use it in third person with domain-appropriate terminology. Its main weaknesses are a single-action capability list and an abstract 'use when' condition that lacks concrete user-facing trigger phrases.

Suggestions

Enumerate 2-3 concrete capabilities in the description (e.g., draft SOP sections, generate version-control and signature blocks, define roles and QC checkpoints) to raise specificity.

Rewrite the 'use when' clause with concrete triggers such as 'Use when the user asks for an SOP, procedure document, or work instruction, or mentions GCP compliance for lab or clinical procedures'.

Add common synonyms like 'protocol', 'work instruction', or 'procedure documentation' to improve trigger term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('laboratory, clinical, or research workflows') and one concrete action ('Write GCP-compliant standard operating procedures') plus qualifiers ('roles, steps, and control points'), but does not list several distinct actions, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not a 4 because no additional specific capabilities (e.g., reviewing, versioning, formatting SOPs) are enumerated.

3 / 5

Completeness

Both parts are present: 'what' ('Write GCP-compliant standard operating procedures for laboratory, clinical, or research workflows') and an explicit 'when' ('use when a reproducible SOP with roles, steps, and control points is required'). It is not a 5 because the 'when' clause describes abstract conditions rather than concrete user trigger phrases (e.g., 'when the user asks for an SOP or procedure document').

4 / 5

Trigger Term Quality

It includes natural terms users would say such as 'standard operating procedures', 'SOP' (via 'SOP' being the standard acronym, spelled out here), 'GCP-compliant', and the three domain settings. It falls short of 5 because common variations like 'protocol', 'work instruction', or 'procedure documentation' are absent.

4 / 5

Distinctiveness Conflict Risk

The SOP/GCP compliance niche is fairly distinct with domain-specific triggers, giving minimal conflict risk with unrelated skills. It is not a 5 because it could still overlap with general protocol-writing, document-generation, or clinical-research-writing skills.

4 / 5

Total

15

/

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.