product-marketing-context

When the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' or wants to avoid repeating foundational information across marketing tasks. Creates `.claude/product-marketing-context.md` that other marketing skills reference.

Quality

76%

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 ./.claude/skills/product-marketing-context/SKILL.md

Quality

Content

75%Weight 40%Scale 1-5

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

A well-structured, actionable instruction-only skill with a clear multi-step workflow and concrete gathering guidance plus a ready-to-use document template. Minor conciseness trims and a couple of thin section bullets are the only real weaknesses.

Suggestions

Trim evaluative filler like 'This is faster than starting from scratch' and 'Most users prefer option 1' that assume rather than instruct.

Flesh out the thinner capture sections (e.g., Brand Voice, Goals) with a sample question or one-line prompt to match the specificity of the Customer Language section.

Consider moving the full Step 3 document template into a reference file and linking to it from SKILL.md to further reduce inline token weight.

Dimension	Reasoning	Score
Conciseness	The body is efficient and purposeful—structured sections, a concrete template, and tight tips with only minor instances of over-explanation ('This is faster than starting from scratch,' 'Most users prefer option 1') that could be trimmed.	4 / 5
Actionability	Provides concrete, specific guidance—per-section bullet lists of what to capture, a copy-paste-ready document template, and example question phrasings ('What's the #1 frustration that brings them to you?'); minor gaps remain in some thin bullet sections.	4 / 5
Workflow Clarity	Clear four-step sequence (check existing, gather, create, confirm/save) with explicit feedback checkpoints ('Confirm accuracy,' 'Iterate until the user is satisfied,' 'Validate as you go'); conversational rather than hard validation, so it sits below the top anchor.	4 / 5
Progressive Disclosure	Well-organized into clearly labeled sections (Workflow, Sections to Capture, Steps, Tips) with no unnecessary external references; the large inline template is integral but could optionally be split out, leaving it just below the top anchor.	4 / 5
	Total	16 / 20 Passed

Description

78%Weight 40%Scale 1-5

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, well-structured description in third-person voice that clearly states both purpose and trigger conditions with natural keyword coverage. It is slightly light on concrete action breadth and has minor overlap risk with sibling marketing skills.

Dimension	Reasoning	Score
Specificity	Names the domain ('product marketing context document') and two concrete actions ('create or update', 'Creates `.claude/product-marketing-context.md`') but the action set is narrow and not comprehensive, matching the 'names domain and 1-2 concrete actions' anchor.	3 / 5
Completeness	Explicitly answers both what ('Creates `.claude/product-marketing-context.md` that other marketing skills reference') and when ('When the user wants to create or update...', 'Also use when the user mentions...') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Lists several natural phrases users would say ('product context,' 'marketing context,' 'set up context,' 'positioning') with good synonym coverage; a few common variations are missing, so it sits just below the comprehensive anchor.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (a shared marketing context document) with distinct triggers, though 'positioning' and the marketing domain create minor overlap with related marketing skills.	4 / 5
	Total	16 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: TheCraigHewitt/seomachine
Path: .claude/skills/product-marketing-context/SKILL.md
Commit: e818d5e

Reviewed: 7 days 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.