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.

48

Quality

53%

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/content-research-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 skill delivers genuinely actionable writing-partner guidance with strong templates, worked examples, and clearly sequenced workflows, but it is bloated with user-facing advice and opinionated tips that waste context, and it makes no use of progressive disclosure — everything is inlined in one long file. Trimming the Pro Tips/Best Practices sections and moving templates and examples into reference files would improve both conciseness and structure.

Suggestions

Cut or drastically trim 'Pro Tips', 'Best Practices', and 'Related Use Cases' — they advise the human user rather than instruct Claude and consume tokens without adding capability.

Move the feedback template, citation format guide, and Examples 1-4 into reference files (e.g. references/templates.md, references/examples.md) and keep SKILL.md as a concise overview with clearly signaled one-level-deep links.

Embed source-verification as an explicit checkpoint in the 'Conduct Research' workflow step rather than leaving it as a passive bullet under 'Best Practices'.

DimensionReasoningScore

Conciseness

The 539-line body contains multiple padded sections that assume neither Claude's intelligence nor the skill's purpose: 'Pro Tips' ('Read aloud', 'Take breaks', 'Set deadlines'), 'Best Practices' directed at the user ('Be specific about what you want'), and platform opinions ('Work in VS Code: Better than web Claude for long-form writing'). This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections'); it is not a 1 because it does not explain basic concepts Claude already knows, and not a 3 because the padding is substantial rather than occasional.

2 / 5

Actionability

Concrete artifacts throughout: a full outline template, three explicit citation formats (inline, numbered, footnote), a structured feedback format, and fully worked examples (Example 3's hook rewrites, Example 4's filled-in section feedback). This fits anchor 4 ('mostly executable guidance... with minor gaps'); it is not a 5 because many core templates remain placeholder scaffolding ([Strength 1], [positive elements], [citation]) rather than concrete instances.

4 / 5

Workflow Clarity

An explicit 8-step instruction sequence (understand project → outline → research → hooks → feedback → voice → citations → final review) plus four per-format workflows (blog, newsletter, tutorial, thought leadership), with iteration loops ('Iterate on outline', feedback after each section) and a pre-publish checklist. This matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'); it is not a 5 because verification steps like 'verify sources before citing' are buried in Best Practices rather than embedded as checkpoints in the workflow itself.

4 / 5

Progressive Disclosure

The body has clear section headers but is a 539-line monolith with no bundle files at all — feedback templates, citation formats, examples, and format-specific workflows are all inlined content that belongs in separate reference files. This matches anchor 3 ('some structure... content that should be separate is inline'); it is not a 2 because the internal structure and navigation via headers is genuinely good, not minimal.

3 / 5

Total

13

/

20

Passed

Description

50%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.

The description communicates a clear set of concrete capabilities but reads as marketing copy in its second sentence, which both triggers the second-person penalty and adds no trigger information. It entirely lacks a 'Use when...' clause, capping completeness and leaving trigger coverage thin. Adding explicit trigger conditions and natural user phrasing like 'blog posts', 'articles', or 'newsletters' would raise most dimensions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when writing blog posts, articles, newsletters, or tutorials, or when the user asks to research a topic, add citations, or improve a hook or outline.'

Remove the second-person fluff sentence 'Transforms your writing process from solo effort to collaborative partnership' and keep the description in third person.

Include natural synonyms users would say ('draft', 'edit', 'blog post', 'article') to broaden trigger-term coverage beyond 'content' and 'writing'.

DimensionReasoningScore

Specificity

The description lists five concrete actions ('conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section'), which would anchor at 4, but the closing sentence 'Transforms your writing process from solo effort to collaborative partnership' is second-person voice, incurring the rubric's mandatory 1-point specificity penalty. It is not a 4 because the penalty applies, and not a 2 because the action list is genuinely concrete, not generic.

3 / 5

Completeness

The 'what' is clearly stated (research, citations, hooks, outlines, section feedback), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which the judging guidelines cap at 3. It is not a 2 because the 'what' is concrete rather than vague, and not a 4 because no 'when' is present even weakly.

3 / 5

Trigger Term Quality

Terms like 'writing', 'research', 'citations', 'hooks', and 'outlines' are natural user phrasing, but common variations users actually say — 'blog post', 'article', 'newsletter', 'draft', 'edit', 'proofread' — are absent. It fits anchor 3 ('some relevant keywords but missing common variations or synonyms') better than 4, which requires only 'a few' missing natural terms.

3 / 5

Distinctiveness Conflict Risk

The opening phrase 'writing high-quality content' is broad and would overlap with general editing, proofreading, or documentation skills, though the specific actions (hook improvement, section-by-section feedback) provide some distinction. This matches anchor 3 ('somewhat specific but could still overlap with similar skills') rather than 4, since the domain framing is generic.

3 / 5

Total

12

/

20

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.

Validation — 14 / 16 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

14

/

16

Passed

Repository
MoizIbnYousaf/ai-agent-skills
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.