CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

journal-recommender

Recommend academic journals based on manuscript topic, abstract, and impact factor expectations. Use when the user wants to find suitable journals for their research manuscript, especially when they provide a topic, abstract, and target Impact Factor.

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/journal-recommender/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 journal-specific core (output table format, inputs, tier definitions) is solid, but it is buried under ~60 lines of generic boilerplate that applies to any skill. The script dependency is named but never demonstrated on real input, and the expected validation output is inaccurate. The result is a skill that tells Claude what to produce more clearly than how to produce it.

Suggestions

Cut the boilerplate sections (When to Use / When Not to Use / Required Inputs / Output Contract / Failure Handling / User Checkpoints) down to the few rules that actually apply to journal recommendation, reclaiming the token budget.

Show an executable invocation of `python scripts/journal_ranker.py` with real journal text and expected sorted output, and bundle or reference an actual CAS warning-list data file so the exclusion rule is actionable.

Fix the Quick Validation expected output to match what `journal_ranker.py --help` actually prints, and specify at which workflow step the sorting script runs.

DimensionReasoningScore

Conciseness

Roughly half the body is generic template boilerplate — "Use this skill when the request matches its documented task boundary", "Do not use this skill when the required source data, identifiers, files, or credentials are missing", and the Output Contract / Failure Handling / User Checkpoints blocks — that adds no journal-specific information. This matches anchor 2: several padded sections.

2 / 5

Actionability

The output table template with a filled example row and the explicit inputs list are concrete, but there is no executable example of running journal_ranker.py on real input (only --help), the mandated CAS warning list has no bundled data source, and the assessment step is abstract ("Extract keywords and determine the specific research field"). Anchor 3: some concrete guidance but missing key details.

3 / 5

Workflow Clarity

A real sequence exists (Assess Manuscript → Recommend Journals, plus quality rules and a Quick Validation step), but the Quick Validation's "Expected output format" ("Result file: journal_recommender_result.md...") does not match what `--help` would actually print, and where the sorting script fits in the actual generation workflow is never specified. Anchor 3: steps listed but checkpoints flawed/implicit.

3 / 5

Progressive Disclosure

Single SKILL.md with clearly signaled sections and one verified one-level-deep bundle reference (`scripts/journal_ranker.py`, which exists). Two organization gaps keep it from anchor 5: the CAS warning list the skill depends on is not bundled or referenced as a file, and the Output Format section oddly precedes the document title and 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 well-constructed description with an explicit, concrete 'Use when...' trigger clause and clear niche positioning. Its main weakness is limited action specificity — it states one capability rather than the full range of things the skill does (tiered recommendations, IF sorting, warning-list filtering).

Suggestions

Expand the capability statement to enumerate the concrete actions, e.g. "Recommends journals in Sprint/Robust/Safe tiers sorted by Impact Factor while excluding CAS warning-list journals" to lift specificity.

Add common user phrasings such as "where to publish", "journal submission", or "IF" as trigger terms to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — "Recommend academic journals based on manuscript topic, abstract, and impact factor expectations" — but stops at a single action verb, not the several specific actions (tiered categorization, IF sorting, warning-list exclusion) that anchor 4 requires.

3 / 5

Completeness

It explicitly answers both what ("Recommend academic journals based on manuscript topic, abstract, and impact factor expectations") and when ("Use when the user wants to find suitable journals for their research manuscript, especially when they provide a topic, abstract, and target Impact Factor") with concrete trigger conditions, matching anchor 5.

5 / 5

Trigger Term Quality

Natural terms users would say are well covered: "find suitable journals", "research manuscript", "topic", "abstract", "target Impact Factor". A few common variations ("where to publish", "submit my paper", "IF") are missing, so it falls just below anchor 5.

4 / 5

Distinctiveness Conflict Risk

Journal selection for a manuscript is a clear, well-triggered niche, but it sits in the academic-publishing space where literature-search or paper-writing skills could partially overlap, so anchor 4 (mostly distinct, minor overlap risk) fits better than 5.

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/journal-recommender/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.