CtrlK
BlogDocsLog inGet started
Tessl Logo

content-research-writer

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

Quality

40%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/content-research-writer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
0xrabbidfly/eric-cartman
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.