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
26%
Does it follow best practices?
Impact
98%
1.44xAverage score across 6 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/content-research-writer/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
74c7031
Table of Contents
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.