content-writer-agent

Authoring playbook for building agents that draft written content — blog posts, marketing copy, social media posts, newsletters, product descriptions, landing pages, or ad copy. Use this when the user wants an agent that writes, drafts, or rewrites text for publication or marketing.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./packages/editor/src/ee/workspace/skills/content-writer-agent/SKILL.md

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, actionable authoring playbook with concrete defaults, a reusable prompt template, and a worked example. Its main gaps are mild internal redundancy, an implicit rather than explicit build workflow, and no progressive disclosure to separate reference files.

Suggestions

Add an explicit numbered build sequence (e.g., 1. pick format, 2. set brand voice + banned phrases, 3. fill the system prompt template, 4. verify against completion criteria) so the workflow is sequenced with checkpoints, not just topical.

Consolidate the 'Required behavioral rules to enforce' section with the system prompt template to remove the duplicated completion-criteria and voice-disclosure content and tighten token use.

Consider externalizing the full worked example and/or the system prompt template into a reference file (e.g., examples.md) so SKILL.md stays a lean overview with one-level-deep pointers.

Dimension	Reasoning	Score
Conciseness	The guidance is mostly lean and assumes Claude's competence, but the 'Required behavioral rules to enforce' section restates the completion criteria and voice discipline already embedded in the system prompt template.	2 / 3
Actionability	Highly actionable for an instruction-only skill: concrete word-count defaults per format, specific SEO placement rules, a fill-in-the-blank system prompt template, a completion checklist, and a full worked example.	3 / 3
Workflow Clarity	Content is organized topically rather than as an explicit numbered build workflow; the four-point completion checklist provides an end-state checkpoint but intermediate sequence steps and feedback points are only implicit.	2 / 3
Progressive Disclosure	Sections are clearly headed and self-contained, but it is a single ~100-line monolithic file with no reference split — the large system-prompt template and worked example are inline content that could be externalized.	2 / 3
	Total	9 / 12 Passed

Description

92%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what-and-when triggers, natural keyword coverage, and concrete format enumeration. The only real weakness is moderate overlap risk with direct writing skills on shared content keywords.

Suggestions

Lead the 'Use when...' clause with the building framing (e.g., 'Use when the user wants to BUILD or CREATE an agent that writes...') so it does not compete with direct content-creation skills.

Add 'build an agent', 'create a writer agent', or 'set up a copywriting agent' as explicit trigger phrases to make the authoring intent unambiguous.

Dimension	Reasoning	Score
Specificity	Concrete actions (build, draft, write, rewrite) are paired with an enumerated list of seven specific deliverables (blog posts, marketing copy, newsletters, ad copy, etc.) with no vague language.	3 / 3
Completeness	It states what it does ('Authoring playbook for building agents that draft written content') and gives an explicit 'Use this when...' clause naming the trigger conditions, satisfying both what and when.	3 / 3
Trigger Term Quality	Natural user-facing terms are well covered — 'blog posts', 'marketing copy', 'newsletters', 'ad copy', and 'writes, drafts, or rewrites text' are exactly what a user would say.	3 / 3
Distinctiveness Conflict Risk	The 'agent that writes' qualifier distinguishes it as a builder skill, but the dense set of common writing keywords (blog, marketing copy, ad copy) could still overlap with direct content-creation skills.	2 / 3
	Total	11 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: mastra-ai/mastra
Path: packages/editor/src/ee/workspace/skills/content-writer-agent/SKILL.md
Commit: 3b78ed9

Reviewed: about 23 hours ago

Table of Contents

Discovery Implementation Validation

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.