A token-efficient writing partner that uses bounded research, numbered citations, evidence packets, and parallel sub-agents to outline, draft, and refine high-quality content with minimal context growth.
40
40%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/content-research-writer/SKILL.mdQuality
Discovery
17%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 is overly focused on internal implementation details (bounded research, parallel sub-agents, context growth) rather than user-facing capabilities and trigger scenarios. It lacks natural language keywords users would use and has no explicit 'Use when...' guidance, making it difficult for Claude to know when to select this skill from a pool of options.
Suggestions
Add a 'Use when...' clause with natural trigger terms like 'write an article', 'draft a blog post', 'research and write', 'essay', 'long-form content', or 'writing with citations'.
Replace implementation jargon ('bounded research', 'parallel sub-agents', 'minimal context growth') with user-facing language describing concrete outputs and content types (e.g., 'articles, essays, reports with inline citations').
Specify the types of content this skill handles to distinguish it from general writing skills, e.g., 'research-backed articles, cited reports, academic writing'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names some actions ('outline, draft, and refine') and mentions techniques ('bounded research, numbered citations, evidence packets, parallel sub-agents'), but these are more architectural/process descriptors than concrete user-facing capabilities. It doesn't specify what kind of content or what concrete outputs are produced. | 2 / 3 |
Completeness | While it partially addresses 'what' (outline, draft, refine content), there is no 'Use when...' clause or equivalent explicit trigger guidance. The description focuses on internal implementation details rather than when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also weak, so this scores 1. | 1 / 3 |
Trigger Term Quality | The description uses technical jargon like 'bounded research', 'evidence packets', 'parallel sub-agents', and 'context growth' that users would never naturally say. Natural terms like 'write', 'article', 'blog post', 'essay', 'research paper', or 'editing' are largely absent. | 1 / 3 |
Distinctiveness Conflict Risk | The mention of specific techniques like 'numbered citations' and 'evidence packets' provides some distinctiveness, but 'writing partner' and 'outline, draft, and refine' are broad enough to overlap with any general writing or content creation skill. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured process skill with a clear multi-phase workflow, explicit constraints, and thoughtful guardrails for token efficiency. Its main weaknesses are moderate redundancy (constraints repeated across sections), lack of executable/concrete examples (no actual code, tool calls, or copy-paste templates), and a monolithic structure that could benefit from splitting detailed reference material into separate files.
Suggestions
Provide a concrete, copy-paste-ready evidence packet template file (e.g., as a markdown code block or referenced EP-template.md) rather than describing the format in prose twice.
Add an executable example of sub-agent invocation showing the actual tool call pattern and a sample returned output, rather than only describing the schema in bullets.
Extract the folder structure, naming conventions, and evidence packet schema into a referenced REFERENCE.md file to reduce the main skill's length and practice the progressive disclosure the skill advocates.
Remove the redundant restatement of research mode constraints in Phase 2 since they are already captured in the 'Key Constraints at a Glance' table.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some redundancy—key constraints are stated in the table and then repeated in Phase 2, evidence packet schema appears both in Phase 4 and in a standalone section, and some explanatory text (e.g., 'This skill acts as your writing partner') is unnecessary padding. It could be tightened by ~30% without losing information. | 2 / 3 |
Actionability | The skill provides concrete schemas, folder structures, naming conventions, and a strict output format for sub-agents, which is good. However, there is no executable code or copy-paste-ready commands—everything is described in prose/bullet form. The sub-agent invocation pattern is described conceptually but not with actual tool calls or concrete implementation examples. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced across well-labeled phases (0–6) with an overview summary. It includes explicit stop conditions, no-source fallback handling, an escalation ladder for when evidence can't be found, and a merge rule for sub-agent outputs. The escalation ladder in the guardrails section serves as a feedback loop for blocked research paths. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear sections and headers, but it's entirely monolithic—everything lives in a single file with no references to supporting files. The folder structure section and evidence packet template could be split into referenced files. Given no bundle files exist, the skill misses an opportunity to practice the progressive disclosure it preaches. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
17bd06f
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.