CtrlK
BlogDocsLog inGet started
Tessl Logo

prior-auth-letter-drafter

Generate professional prior authorization request letters for insurance companies with proper clinical justification and formatting.

51

Quality

40%

Does it follow best practices?

Impact

Pending

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/prior-auth-letter-drafter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

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—prior authorization letters for insurance—which reduces conflict risk. However, it lacks an explicit 'Use when...' clause and could benefit from more specific action details and additional trigger term variations that users commonly use in this domain.

Suggestions

Add a 'Use when...' clause with trigger terms like 'prior auth', 'PA letter', 'insurance approval', 'pre-authorization', 'medical necessity'.

List more specific concrete actions such as 'compiles diagnosis codes, references clinical guidelines, structures medical necessity arguments, and formats letters per payer requirements'.

DimensionReasoningScore

Specificity

Names the domain (prior authorization) and a couple of actions (generate letters, clinical justification, formatting), but doesn't list multiple specific concrete actions like what sections are included, what data is extracted, or what formats are supported.

2 / 3

Completeness

Clearly answers 'what does this do' (generate prior authorization request letters with clinical justification and formatting), but lacks an explicit 'Use when...' clause specifying when Claude should select this skill, which caps this at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

Includes good natural terms like 'prior authorization', 'insurance companies', and 'clinical justification', but misses common variations users might say such as 'prior auth', 'PA letter', 'insurance approval', 'pre-authorization', 'medical necessity letter', or 'denial appeal'.

2 / 3

Distinctiveness Conflict Risk

Prior authorization request letters for insurance companies is a very specific niche that is unlikely to conflict with other skills. The combination of medical/insurance domain with letter generation creates a clear, distinct trigger profile.

3 / 3

Total

9

/

12

Passed

Implementation

22%

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

This skill is heavily padded with generic boilerplate (risk assessment, security checklist, lifecycle status, evaluation criteria, response templates) that consumes tokens without adding domain-specific value for prior authorization letter drafting. The actual domain knowledge—what makes a good prior auth letter, clinical justification patterns, carrier-specific requirements—is almost entirely absent from the content, delegated to external files without any inline examples. The circular section references ('See ## Features above') suggest auto-generated content that wasn't reviewed.

Suggestions

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template, Output Requirements) and replace with a concrete example of a generated prior authorization letter showing the expected output format.

Add domain-specific workflow steps: validate ICD-10/CPT code pairing, check carrier-specific requirements from carrier_requirements.json, verify clinical justification addresses medical necessity criteria, and validate letter format before output.

Eliminate circular self-references ('See ## Features above', 'See ## Prerequisites above') and consolidate duplicated content into a single logical flow.

Include at least one inline example of clinical justification language and letter structure so Claude can generate letters even without access to the reference files.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Features above', 'See ## Prerequisites above', 'See ## Usage above'). Generic boilerplate dominates (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that adds no domain-specific value. The same description is repeated verbatim multiple times. Much content (error handling philosophy, response templates, output requirements) is generic Claude behavior that doesn't need to be taught.

1 / 3

Actionability

The input parameters table and service types are concrete and useful. The command examples are specific. However, the actual letter generation logic is entirely delegated to scripts/main.py with no inline example of what a generated letter looks like, no template structure shown, and no executable code for the core task. The 'Audit-Ready Commands' provide real commands but the workflow steps are generic and not specific to prior authorization letters.

2 / 3

Workflow Clarity

The workflow section is entirely generic ('Confirm the user objective', 'Validate that the request matches the documented scope') with no steps specific to prior authorization letter drafting. There are no validation checkpoints for the medical content (e.g., verifying ICD-10 codes match the clinical justification, checking carrier-specific requirements). The 'Example run plan' is also generic. For a medical document generation task, missing validation of clinical accuracy is a significant gap.

1 / 3

Progressive Disclosure

References to external files (references/letter_template.docx, references/clinical_phrases.md, references/carrier_requirements.json) are well-signaled and one level deep. However, the circular self-references ('See ## Features above') are confusing and suggest poor organization. The document is monolithic with many sections that could be separated or removed entirely.

2 / 3

Total

6

/

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.