CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

multi-source-news-writer

Integrates multiple news sources into a single, cohesive press release using an inverted pyramid structure and AP style. Use when you have raw news content and a topic, and need a professional press release.

Quality

69%

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/Other/multi-source-news-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 skill has a sound skeleton — a clear 3-step workflow and an appropriate one-level-deep reference file containing the concrete writing rules — but the body is buried under ~100 lines of generic template boilerplate, contains contradictory validation instructions, a broken cross-reference, and an unrunnable example path. Trimming the boilerplate and consolidating the validation guidance would substantially improve it.

Suggestions

Delete or drastically trim the generic template sections (Key Features, Implementation Details, Output Contract, Deterministic Output Rules, Completion Checklist) — 'Key Features' merely repeats the description verbatim and 'Implementation Details' is pure filler; keep only sections that carry task-specific content.

Resolve the validation contradiction: pick one story — either the 'Validation Shortcut' script run or the 'Quick Validation' claim that no script is needed — and make the script actually check something about the task (e.g., verify character limits from writing_guidelines.md) instead of just printing 'ok'.

Fix the broken navigation and example: change 'See `## Workflow` above' to point at the actual section location (or remove it), and replace the environment-specific path '20260316/scientific-skills/Others/multi-source-news-writer' with a repo-relative path that will resolve for users.

DimensionReasoningScore

Conciseness

The body is noticeably verbose with several padded boilerplate sections: 'Key Features' repeats the frontmatter description verbatim ('Scope-focused workflow aligned to: Integrates multiple news sources...'), and 'Implementation Details' offers generic filler like 'Execution model: validate the request, choose the packaged workflow, and produce a bounded deliverable' that adds nothing Claude doesn't already know. The genuinely task-specific content (When to Use, Workflow, Rules, References) is only ~25 of 134 lines. Not a 1 because there is no fundamental-concept explanation (e.g., what a press release is) and the core sections are accurate.

2 / 5

Actionability

There is some concrete guidance: executable commands ('python scripts/validate_skill.py --help', verified present in the bundle), a real referenced guidelines file with 5W1H extraction, and a workflow step 'Produce the press release in the specified Markdown format'. But key details of the deliverable live only in the reference file, the 'Example Usage' path ('cd "20260316/scientific-skills/Others/multi-source-news-writer"') references an environment-specific directory that will not resolve, and no example input/output of a press release appears anywhere in the body. Not a 4 because the executable guidance has real gaps (broken example path, format only defined externally).

3 / 5

Workflow Clarity

The Workflow section lists a clear 3-step sequence (Analyze Inputs → Apply Guidelines → Generate Output) and a Completion Checklist exists, so the sequence is coherent. But validation checkpoints are muddled and contradictory: 'Validation Shortcut' says to run 'python scripts/validate_skill.py --help' while 'Quick Validation' states 'No local script validation step is required for this skill', and the script itself only prints 'validation-helper: ok' — it validates nothing about the actual task. There is no validate-and-fix feedback loop for the press-release output itself (e.g., checking character limits from the guidelines).

3 / 5

Progressive Disclosure

The bundle structure is good: 'references/writing_guidelines.md' exists, is clearly linked in a References section, is exactly one level deep, and appropriately holds the detailed rules (character limits, output format) while SKILL.md stays an overview; 'scripts/validate_skill.py' also exists and is referenced by its real path. Not a 5 because navigation is degraded by a broken pointer ('See `## Workflow` above' — the Workflow section actually appears *below* Implementation Details) and duplicated/contradictory validation sections that fragment the overview.

4 / 5

Total

12

/

20

Passed

Description

78%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 states what the skill does and gives explicit 'Use when' trigger conditions with concrete natural terms. The main deductions are the second-person phrasing in the trigger clause (penalized per rubric voice rule) and missing common synonyms like 'news article' or 'announcement'.

Suggestions

Rewrite the trigger clause in third person to avoid the specificity penalty, e.g. 'Use when the user has raw news content and a topic and needs a professional press release.'

Add common synonyms to broaden trigger matching, e.g. 'news articles', 'media release', or 'announcement' alongside 'press release'.

Sharpen distinctiveness by naming the differentiating constraint, e.g. 'merging multiple conflicting sources' rather than just 'multiple news sources'.

DimensionReasoningScore

Specificity

The capability clause 'Integrates multiple news sources into a single, cohesive press release using an inverted pyramid structure and AP style' names the domain plus 2-3 concrete actions (integrate sources, apply inverted pyramid, apply AP style), which is a base 4. However, the trigger clause 'Use when you have raw news content and a topic' uses second person, which the rubric explicitly penalizes by reducing specificity by 1. It is not a 2 because the actions are genuinely concrete, not generic like 'Processes PDF files'.

3 / 5

Completeness

It explicitly answers both questions: what ('Integrates multiple news sources into a single, cohesive press release using an inverted pyramid structure and AP style') and when ('Use when you have raw news content and a topic, and need a professional press release') with concrete trigger conditions, matching the anchor-5 exemplar pattern exactly. Not a 4 because the 'when' clause is already fully explicit and specific.

5 / 5

Trigger Term Quality

Natural terms present: 'news sources', 'raw news content', 'press release', 'professional press release', 'topic' — a user needing this skill would plausibly say these. A few natural variations are missing ('news article', 'announcement', 'media release'), which keeps it below the comprehensive synonym coverage of a 5 but clearly above the thin keyword coverage of a 3.

4 / 5

Distinctiveness Conflict Risk

The AP-style press-release synthesis niche with named structural conventions (inverted pyramid) is mostly distinct with only minor overlap risk against generic writing/editing skills. Not a 5 because 'press release' writing is a moderately common request type that could overlap with general document-drafting skills, and the description lacks a sharper differentiator.

4 / 5

Total

16

/

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

scientific-skills/Other/multi-source-news-writer/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.