CtrlK
BlogDocsLog inGet started
Tessl Logo

content-research-writer

Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.

68

1.44x
Quality

26%

Does it follow best practices?

Impact

98%

1.44x

Average score across 6 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/business-productivity/content-research-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

25%

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 lists several writing-related actions but remains too broad and generic to serve as an effective skill selector among many skills. It lacks a 'Use when...' clause, uses second person ('your writing process') which violates voice guidelines, and includes marketing fluff ('Transforms your writing process from solo effort to collaborative partnership') that adds no discriminative value.

Suggestions

Add an explicit 'Use when...' clause with trigger terms, e.g., 'Use when the user asks for help writing articles, blog posts, essays, or long-form content, or mentions needing citations, outlines, or hooks.'

Remove the marketing fluff sentence ('Transforms your writing process from solo effort to collaborative partnership') and replace it with concrete capability details or supported content types.

Switch from second person ('your writing process') to third person voice (e.g., 'Assists users in writing high-quality content' or 'Conducts research and adds citations for long-form writing projects').

DimensionReasoningScore

Specificity

Names several actions like 'conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback,' but these are somewhat generic writing-related activities rather than highly concrete, tool-specific operations. The last sentence ('Transforms your writing process...') is vague marketing fluff.

2 / 3

Completeness

The description answers 'what does this do' reasonably well but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'when' is not even implied clearly, warranting a 1.

1 / 3

Trigger Term Quality

Includes some relevant keywords like 'writing,' 'research,' 'citations,' 'hooks,' and 'outlines' that users might naturally mention. However, it misses common variations and broader trigger terms like 'essay,' 'article,' 'blog post,' 'draft,' 'editing,' or 'proofreading.'

2 / 3

Distinctiveness Conflict Risk

The description is very broad — 'writing high-quality content' could overlap with virtually any writing, editing, or content creation skill. There are no distinct file types, formats, or niche triggers that would differentiate it from other writing-related skills.

1 / 3

Total

6

/

12

Passed

Implementation

27%

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

This skill is excessively verbose, treating Claude like a novice writer who needs to be taught what hooks, citations, and outlines are. The templates and examples provide some structure but are largely padded with obvious guidance. The skill would benefit enormously from being condensed to ~25% of its current length, focusing only on the specific behavioral instructions Claude needs rather than generic writing advice.

Suggestions

Cut the file to under 100 lines by removing sections Claude already knows (what citations are, what hooks are, generic writing advice like 'take breaks') and keeping only the specific behavioral instructions and output format templates.

Split detailed templates (feedback format, research output format, citation styles) into separate referenced files to improve progressive disclosure and reduce the main file's cognitive load.

Add concrete validation checkpoints to workflows, e.g., 'Confirm outline approval with user before proceeding to draft' and 'Verify all citations have sources before final review'.

Replace vague research instructions ('Search for relevant information, find credible sources') with specific tool usage guidance (e.g., which search tools to use, how to verify source credibility).

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Explains obvious concepts Claude already knows (what a hook is, what citations are, how to mkdir). Massive template blocks that could be summarized in a few lines. The 'When to Use This Skill' and 'What This Skill Does' sections are redundant with each other and with the actual instructions. Pro tips like 'Take breaks' and 'Set deadlines' are generic life advice, not skill-specific guidance.

1 / 3

Actionability

Provides structured templates and example outputs (feedback format, research format, citation styles), which is somewhat concrete. However, the guidance is largely about prompting patterns ('Help me create an outline for...') rather than executable code or specific tool commands. The research section says 'Search for relevant information' without specifying how (which tools, which commands). Much of the content is template scaffolding rather than truly actionable instructions.

2 / 3

Workflow Clarity

Multiple workflows are listed (blog post, newsletter, tutorial, thought leadership) with numbered steps, providing decent sequencing. However, there are no validation checkpoints or feedback loops for error recovery. The workflows are high-level checklists without explicit verification steps (e.g., no 'confirm outline approval before proceeding to draft' gates). The main 8-step instruction process has clear ordering but lacks explicit decision points.

2 / 3

Progressive Disclosure

Everything is crammed into a single monolithic file with no references to external files. The content includes extensive inline templates, multiple workflow types, examples, best practices, and file organization guidance all in one document. Content like the detailed feedback template, citation format examples, and individual workflow types could easily be split into referenced files. No bundle files exist to support progressive disclosure.

1 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (540 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
majiayu000/claude-skill-registry
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.