lay-press-release-writer

Transform academic papers into university press releases for general.

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/lay-press-release-writer/SKILL.md

Quality

Content

60%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 content provides executable commands, a clear workflow with fallback, and a real reference file, but is weighed down by extensive generic boilerplate that adds tokens without proportional value. Tightening the body would markedly improve it.

Suggestions

Remove or relocate generic boilerplate (Capabilities, Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that Claude already knows or that adds little actionable value.

Move detailed process/output guidance into references/ and keep SKILL.md as a lean overview with one-level-deep links.

Add an explicit validate-fix-retry loop for script execution failures rather than a single fallback statement.

Dimension	Reasoning	Score
Conciseness	The body contains many boilerplate sections (Key Features, Implementation Details, Metadata, Capabilities, Risk Assessment, Security Checklist, Lifecycle Status, Output Requirements) restating generic process guidance Claude already knows, fitting the 2 anchor for noticeable verbosity and padding; not a 3 because the volume of generic boilerplate is substantial.	2 / 5
Actionability	Concrete executable commands (py_compile, --help), a flagged usage example, an input parameter table, and a complete JSON output schema give mostly executable guidance; not a 5 because the core drafting logic is delegated to scripts/main.py with minor gaps.	4 / 5
Workflow Clarity	The Workflow lists a clear sequenced 5-step process with validation (stop early on unsupported assumptions) and an explicit error fallback path; not a 5 because some checkpoints are implicit rather than explicit validate-fix-retry loops.	4 / 5
Progressive Disclosure	The body references a real one-level-deep file (references/audit-reference.md, which exists) and is section-organized; not a 5 because substantial generic content remains inlined that could live in reference files.	4 / 5
	Total	14 / 20 Passed

Description

53%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.

The description states a clear, specific transformation but is truncated ("for general."), omits any trigger/usage guidance, and lacks synonyms. It is functional but incomplete and not fully polished.

Suggestions

Complete the description and add an explicit 'Use when...' clause naming natural triggers (e.g. press releases, media summaries, lay summaries of research).

Add 1-2 more concrete actions (extract findings, draft quotes/headlines) and synonyms/file cues to broaden trigger coverage.

Rephrase in clean third person without the dangling 'for general.' fragment.

Dimension	Reasoning	Score
Specificity	"Transform academic papers into university press releases" names the domain and one concrete action, but no further actions (e.g. extract findings, draft quotes) are listed, matching the 3 anchor for 1-2 concrete actions; not a 2 because the transformation is specific, not a 4 because coverage is thin.	3 / 5
Completeness	It conveys a clear (though truncated "for general.") "what" but entirely lacks a "when"/"Use when..." clause, so per the cap it stays at 3; not a 4 because the trigger guidance is missing rather than weakly present.	3 / 5
Trigger Term Quality	"academic papers" and "university press releases" are relevant natural terms, but common variations/synonyms (press release writer, media release, lay summary) are absent, fitting the 3 anchor; not a 4 because keyword coverage is incomplete.	3 / 5
Distinctiveness Conflict Risk	The academic-paper-to-press-release niche is mostly distinct with minor overlap risk against general writing skills; not a 5 because the thin trigger phrasing weakens distinctiveness.	4 / 5
	Total	13 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Academic Writing/lay-press-release-writer/SKILL.md
Commit: 63c61d3

Reviewed: 11 hours ago

Table of Contents

Discovery Implementation Validation

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.