CtrlK
BlogDocsLog inGet started
Tessl Logo

research-topic-extractor

当用户明确要求"从文件/图片/网页/描述中提取综述主题"、"生成主题+关键词+核心问题结构化输出",或要求使用旧名 get-review-theme skill 时使用。支持文件(PDF/Word/Markdown/Tex)、文件夹、图片、自然语言描述、网页 URL 等多种输入源,自动识别输入类型并提取内容,生成可直接用于 research-literature-review 及其他文献综述技能的结构化输出。

52

Quality

58%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/research-topic-extractor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%

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

The body is cleanly organized into a clear 4-step workflow with concrete output structure and error fallbacks, but it stays at a high level: the actionable extraction prompt is locked in an orphaned reference file, validation is implicit, and some meta sections add non-essential tokens.

Suggestions

Link the prompt template explicitly from the workflow (e.g., '详细抽取 prompt 见 [prompt_templates.md](references/prompt_templates.md)') so the actionable guidance is reachable instead of orphaned.

Add an explicit validation checkpoint in the workflow (e.g., '输出前核对:主题含研究对象+问题/方法、关键词为标准检索术语、核心问题具体可检索') before the 格式化 step.

Trim or relocate the BenszAPI workspace and bensz-collect-bugs collaboration sections so the body focuses on the extraction task, improving token efficiency.

DimensionReasoningScore

Conciseness

The core workflow is terse and assumes Claude's competence, but the BenszAPI 任务工作区 and 与 bensz-collect-bugs 的协作约定 meta-conventions are not directly about the extraction task, so not every token earns its place.

2 / 3

Actionability

Gives a concrete output schema (主题/关键词/核心问题) and specific counts (5-10 关键词, 2-5 核心问题), but the actual extraction methodology is vague ("用一句话概括主题") and the real executable prompt lives in the unreferenced references/prompt_templates.md.

2 / 3

Workflow Clarity

The 4-step sequence (识别输入类型 → 提取内容 → 语义提取 → 格式化) is clearly ordered, but validation checkpoints are only implicit — the 质量要求 criteria and 错误处理 fallbacks are not wired into the workflow as an explicit validate-then-proceed step.

2 / 3

Progressive Disclosure

The body is well-sectioned (not a monolithic wall), but the provided references/prompt_templates.md is never linked or signaled from the body, and the prompt content that belongs in that file is partially duplicated inline.

2 / 3

Total

8

/

12

Passed

Description

67%

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 clearly states both what the skill does and when to use it, with explicit quoted triggers and a legacy alias. It is somewhat held back by generic pipeline actions, narrow trigger variation coverage, and a broad input scope that risks overlap with similar extraction skills.

Suggestions

Replace the generic 'auto-identify / extract / generate' pipeline with a few distinct concrete actions (e.g., '提取研究对象、关键词与核心研究问题,输出 topic/keywords/core_questions 三段结构') to lift specificity.

Broaden trigger terms with common variations a user might actually say (e.g., '文献综述主题', '调研主题', 'review topic extraction', '提取研究方向') rather than only two quoted phrasings.

Sharpen distinctiveness by foregrounding the research-literature-review handoff and the topic+keywords+core_questions output shape as the defining niche, so it does not read as a general content extractor.

DimensionReasoningScore

Specificity

Names a concrete domain (文件 PDF/Word/Markdown/Tex、文件夹、图片、URL) and pipeline actions ("自动识别输入类型并提取内容", "生成…结构化输出"), but the actions are a generic identify→extract→generate flow rather than multiple distinct concrete actions like 'extract text, fill forms, merge'.

2 / 3

Completeness

Explicitly answers both: 'when' via "当用户明确要求…时使用" / "或要求使用旧名 get-review-theme skill 时使用", and 'what' via the multi-source input, auto-identify, extract, and structured-output description.

3 / 3

Trigger Term Quality

Quotes natural user utterances ("从文件/图片/网页/描述中提取综述主题", "生成主题+关键词+核心问题结构化输出") plus the legacy alias get-review-theme, but coverage of common variations is narrow rather than broad.

2 / 3

Distinctiveness Conflict Risk

The 综述主题 / research-literature-review / get-review-theme niche is identifiable, but the very broad multi-source 'extract topic from files/images/web' framing could still overlap with general content-extraction or analysis skills.

2 / 3

Total

9

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
huangwb8/ChineseResearchLaTeX
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.