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 ./plugins/all-skills/skills/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 effectively distinguish itself from other writing skills. It lacks a 'Use when...' clause, uses second person ('your writing process'), and ends with a fluffy marketing sentence that adds no selection value. The description needs sharper scoping to a specific content type or use case and explicit trigger guidance.

Suggestions

Add an explicit 'Use when...' clause specifying trigger scenarios, e.g., 'Use when the user asks for help writing articles, blog posts, or long-form content that requires research and citations.'

Narrow the scope to a specific content domain (e.g., 'long-form articles,' 'research-backed blog posts') to reduce conflict risk with other writing skills.

Remove the second-person marketing sentence ('Transforms your writing process...') and replace with concrete capability details or file/format specifics in third person voice.

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-assistance actions rather than highly concrete, tool-specific capabilities. The last sentence is pure marketing fluff.

2 / 3

Completeness

Describes what it does (research, citations, hooks, outlines, feedback) 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 enough to warrant a 2.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'writing,' 'research,' 'citations,' 'hooks,' and 'outlines' that users might mention, but misses common variations like 'blog post,' 'article,' 'essay,' 'draft,' 'editing,' or specific content types. The terms are moderately useful but not comprehensive.

2 / 3

Distinctiveness Conflict Risk

'Writing high-quality content' is extremely broad and would conflict with many other writing-related skills (e.g., blog writing, technical writing, copywriting, editing skills). There is no clear niche or distinct trigger that separates this from general writing assistance.

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 extremely verbose and padded with generic writing advice that Claude already knows. While it provides useful templates and structured formats for feedback and research output, the content could be reduced by 60-70% without losing actionable value. The lack of any bundle files or progressive disclosure means the entire ~400-line document loads into context every time, wasting significant token budget on obvious concepts and redundant sections.

Suggestions

Reduce content by at least 60%: remove 'When to Use', 'What This Skill Does' (redundant with Instructions), generic pro tips ('Take breaks', 'Read aloud'), and 'Related Use Cases' sections entirely.

Split large template blocks (outline template, feedback template, final review template) into separate referenced files like TEMPLATES.md or FEEDBACK_FORMAT.md to improve progressive disclosure.

Add concrete tool usage instructions: specify which tools Claude should use for research (web search, file reading), how to save drafts (which write commands), and explicit validation gates between workflow steps.

Remove explanations of basic concepts Claude already knows (what hooks are, what citations are, how to mkdir) and focus only on the specific patterns and formats you want Claude to follow.

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Explains obvious concepts Claude already knows (what a hook is, what citations are, how to create folders). 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 'Read aloud' are generic writing advice, not actionable skill content.

1 / 3

Actionability

Provides structured templates and example outputs (feedback format, research format, citation styles), which is somewhat concrete. However, most guidance is template-based rather than executable—there are no actual tool calls, no real commands beyond mkdir/touch, and the 'research' steps don't specify how Claude should actually conduct research (which tools to use, which APIs to call). The examples are illustrative but not copy-paste executable.

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 research' 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 file organization section suggests creating separate files (outline.md, research.md) but the skill itself doesn't split its own content. Massive inline templates for outlining, feedback, research, citations, and final review could easily be separate reference files. The content is a wall of text that would benefit enormously from splitting into focused sub-documents.

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
davepoon/buildwithclaude
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.