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 ./skills/business-productivity/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 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').
| 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-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).
| Dimension | Reasoning | Score |
|---|---|---|
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.
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 | |
fa3abd3
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.