CtrlK
BlogDocsLog inGet started
Tessl Logo

using-research-writing

Use when starting any research writing task - establishes workflow and routes to appropriate skills

64

Quality

76%

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 ./skills/using-research-writing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-3

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

The orchestrator body is well-structured with concrete routing, a clear sequenced workflow, and explicit confirmation/audit checkpoints; its main weakness is redundant enforcement prose repeated across several sections. As an instruction-only routing skill it is actionable without code.

Suggestions

Consolidate the repeated 'always call skills / never skip workflow' enforcement (SUBAGENT-STOP, EXTREMELY-IMPORTANT, 核心规则, Red Flags, 用户指令) into a single concise section to remove redundancy.

Verify the ```dot fenced block renders as intended in the target clients (Claude Code, Cursor, Codex, OpenCode), since diagram rendering support varies.

Move the long Red Flags table or skill-type/priority detail into a separate reference file if the body grows, to keep the overview lean.

DimensionReasoningScore

Conciseness

The body is mostly efficient routing content, but the 'always call skills / never skip / no excuses' enforcement theme is restated across SUBAGENT-STOP, EXTREMELY-IMPORTANT, 核心规则, Red Flags, and 用户指令, which is unnecessary repetition that could be tightened, matching 'mostly efficient but includes some unnecessary explanation'. Not a 1 because the routing tables and flowchart earn their place; not a 3 because of the repeated enforcement padding.

2 / 3

Actionability

It provides a concrete task-type→skill routing table, a decision flowchart, an explicit definition of '中型任务', skill-priority ordering, and red-flag checks — specific actionable guidance for an instruction-only orchestrator, matching 'concrete, specific guidance' under the instruction-only relaxation. Not a 2 because the routing criteria are explicit rather than pseudocode-level.

3 / 3

Workflow Clarity

The graphviz flow gives a clear sequence (message → is-writing → is-medium → paper-orchestration → brainstorming → route → execute → update plan → confirm) with explicit checkpoints (per-chapter user confirmation, capability-use audit gate before claiming completion), matching 'clear sequence with explicit validation steps'. Not a 2 because checkpoints are explicit, not implicit.

3 / 3

Progressive Disclosure

No bundle files exist and none are referenced; the ~130-line body is well-organized into clearly headed sections (指令优先级, 如何访问技能, 核心规则, 技能路由, etc.) and points one level deep to peer skills rather than nesting references, matching 'clear overview with well-signaled' structure. Not a 2 because sections are well signaled and there is no inline content that should be split out.

3 / 3

Total

11

/

12

Passed

Description

67%Weight 40%Scale 1-3

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 has an explicit 'Use when...' trigger and states both what and when, but its actions are abstract and it relies on a single trigger term with no common variations, risking overlap with the sub-skills it routes to. It is functional but vague for an orchestrator.

Suggestions

Add concrete routing actions and a few example entry points (e.g., 'Routes tasks to brainstorming, chapter-writing, literature-review, and figure skills') to lift specificity.

Expand trigger terms to natural variations users say ('writing a paper', 'academic writing', 'manuscript draft', '论文写作') to improve trigger coverage.

Narrow the trigger so it does not fire on the same cues as its children, e.g. 'Use when a research-writing task needs workflow setup or skill routing' to reduce conflict risk.

DimensionReasoningScore

Specificity

It names the domain ('research writing task') and two actions ('establishes workflow and routes to appropriate skills'), but those actions are abstract/meta-level rather than concrete capabilities, matching the 'names domain and some actions, but not comprehensive' anchor. It is not a 1 because it does state real actions, and not a 3 because no multiple specific concrete actions are listed.

2 / 3

Completeness

It explicitly answers both when ('Use when starting any research writing task') and what ('establishes workflow and routes to appropriate skills') with an explicit 'Use when...' trigger clause, matching the 'clearly answers both what AND when' anchor. Not a 2 because the 'when' is explicit, not implied.

3 / 3

Trigger Term Quality

The single trigger phrase 'research writing task' is relevant, but common variations a user would naturally say ('writing a paper', 'academic writing', 'manuscript', or the Chinese '论文写作' used throughout the body) are missing, fitting 'some relevant keywords but missing common variations'. Not a 1 because the term is natural, not a 3 because coverage is thin.

2 / 3

Distinctiveness Conflict Risk

'research writing task' is a real niche, but the broad 'any research writing task' trigger and the 'routes to appropriate skills' role overlap heavily with the very sub-skills it dispatches to (brainstorming-research, writing-chapters, etc.), fitting 'somewhat specific but could still overlap with similar skills'. Not a 3 because conflict with its own children is likely; not a 1 because the domain is not generic.

2 / 3

Total

9

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Norman-bury/research-writing-skill
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.