CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

discussion-composer

Composes a Discussion around key findings, mechanisms, clinical relevance, and limitations. Use when writing or improving a Discussion section for any biomedical manuscript — including interpreting results, connecting to prior literature, addressing unexpected findings, framing limitations, and writing the conclusion. Also triggers on "write my discussion", "help me discuss my findings", "how do I compare to prior studies", "write the limitations paragraph", or "draft a discussion for my paper".

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, highly actionable instruction-only skill with a clear workflow, explicit validation gates, and concrete formats, caps, and examples. The main weaknesses are mild redundancy (the fabrication rule repeated three times) and bundle files (a guided CLI script and audit reference) that are never surfaced from the body.

Suggestions

Consolidate the repeated no-fabrication rules into the Hard Rules section and remove the duplicates from Step 2 and the Citation Placeholder Density Rule.

Add a brief section pointing to scripts/main.py for users who want the interactive guided framework, and clarify whether references/audit-reference.md is user-facing or internal tooling.

Add an explicit feedback loop after the Step 3 checklist: instruct to revise the draft for any failed check and re-verify before delivery.

DimensionReasoningScore

Conciseness

The body is efficient instruction-only guidance with no padding that explains concepts Claude already knows, but the no-fabrication rule is stated three times (literature comparison rules, Hard Rules, and the Citation Placeholder Density Rule) and Step 2 partially restates the Recommended Discussion Structure, so some trimming is possible.

4 / 5

Actionability

Guidance is fully concrete: the 6-part structure with sentence counts, the limitation format "[Constraint] → [Impact on interpretation] → [How future work could address it]", the placeholder syntax "[CITE: study showing similar/contrasting result]", quantitative caps ("Maximum 4 placeholders per 400 words"), word/paragraph calibration per manuscript type, and a worked example ("HR 1.43, 95% CI 1.12–1.82"). For an instruction-only skill this is copy-paste-ready guidance.

5 / 5

Workflow Clarity

The four-step sequence (collect inputs → draft → revise checklist → deliver) is clearly ordered with explicit input validation ("If key results are not provided, ask before writing") and an 8-item verification checklist, but there is no explicit fix-and-re-verify feedback loop after the checklist, matching anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Sections are well organized and all body content is appropriately inlined for a ~140-line skill, but bundle files exist (scripts/main.py, references/audit-reference.md) that the body never references or surfaces, leaving a minor navigation gap consistent with anchor 4 rather than the fully navigable anchor 5.

4 / 5

Total

17

/

20

Passed

Description

96%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 description that clearly and explicitly states what the skill does and when to use it, with concrete actions and natural trigger phrases in third-person voice. The only weakness is slight trigger overlap with general academic/manuscript-writing skills.

Suggestions

Qualify the trigger phrases with the biomedical/academic scope (e.g., "write the limitations paragraph of my biomedical paper") to reduce overlap with general academic-writing skills.

Consider adding one or two domain-specific keywords users might say, such as "interpret my findings" or "compare my results to the literature", if not already covered.

DimensionReasoningScore

Specificity

"Composes a Discussion around key findings, mechanisms, clinical relevance, and limitations" plus "interpreting results, connecting to prior literature, addressing unexpected findings, framing limitations, and writing the conclusion" lists multiple specific concrete actions with comprehensive coverage of the domain, matching the score-5 anchor; voice is third person throughout.

5 / 5

Completeness

The first sentence explicitly states what the skill does and "Use when writing or improving a Discussion section for any biomedical manuscript..." explicitly states when to use it with concrete trigger phrases, exactly matching the score-5 anchor pattern.

5 / 5

Trigger Term Quality

Natural user phrasings like "write my discussion", "help me discuss my findings", "how do I compare to prior studies", "write the limitations paragraph", and "draft a discussion for my paper" comprehensively cover the ways a user would naturally request this skill, including synonyms.

5 / 5

Distinctiveness Conflict Risk

The biomedical Discussion-section niche is clear, but generic triggers like "write the limitations paragraph" or "help me discuss my findings" could also fire for a general academic-writing or non-biomedical manuscript skill, giving minor overlap risk consistent with anchor 4 rather than a fully distinct niche.

4 / 5

Total

19

/

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

Path

awesome-med-research-skills/Academic Writing/discussion-composer/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.