CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

product-marketing

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,' 'who is my target audience,' 'describe my product,' 'ICP,' 'ideal customer profile,' 'brand voice,' 'tone of voice,' 'brand guidelines,' 'what have we learned,' 'log this learning,' or wants to avoid repeating foundational information across marketing tasks. Use this at the start of any new project before using other marketing skills — it creates `.agents/product-marketing.md` that all other skills reference for product, audience, and positioning context.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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, highly actionable instruction skill with a clear four-step workflow, user-confirmation checkpoints at every stage, a complete document template, and a properly signaled one-level-deep reference file. The main improvement opportunities are trimming a few rationale sentences and considering whether the learnings-maintenance policy warrants its own reference file.

Suggestions

Trim rationale asides to directives — e.g. reduce 'exact phrases are more valuable than polished descriptions because they reflect how customers actually think and speak, which makes copy more resonant' to 'Push for verbatim customer language — it makes copy more resonant.'

Consider moving the ~40-line 'Maintaining Learnings' policy (entry format, earn/retire rules) into a reference file like references/learnings.md, keeping a 2-3 line summary plus the link in SKILL.md, as was done effectively for brand voice.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely instructional — exact paths, a complete document template, and concrete rules — with only a few rationale asides that could be trimmed, e.g. "exact phrases are more valuable than polished descriptions because they reflect how customers actually think and speak, which makes copy more resonant" and "this doc is the shared context every other marketing skill reads, so a dated paper trail of *what changed and why* is worth keeping." This matches the 4 anchor ("efficient; minor instances of over-explanation that could be trimmed") rather than 3, since the padding is isolated sentences, not sections, and the ~120-line template is necessary content, not filler.

4 / 5

Actionability

Fully actionable for an instruction-only skill: exact file locations including legacy migration paths (`.claude/product-marketing.md`, `product-marketing-context.md`), a copy-paste-ready document template with every section pre-structured, explicit versioning rules with concrete example changelog lines ("- v3 (2026-07-16) — Repositioned from 'email tool' to 'deliverability platform'; added RevOps to the ICP."), and a worked learnings entry format ("Variant B +18% trial starts, 2,400 visitors per arm, 3 weeks"). Per the scoring notes, absence of code is not penalized when guidance is this concrete — this matches the 5 anchor's "specific examples cover the common cases."

5 / 5

Workflow Clarity

The four-step workflow is clearly sequenced (check existing → gather via auto-draft or interview → create → confirm/version/save) with explicit validation checkpoints throughout: "Confirm accuracy" and "Validate as you go: Summarize each section and confirm before moving on," iteration "until the user is satisfied," "Show the completed document / Ask if anything needs adjustment" before save, and "Show the proposed row to the user and add it on approval" for learnings. The "Sections to Capture" list functions as a checklist. This matches the 5 anchor (clear sequence, explicit validation, feedback loops); the operations are user-confirmed document edits, not destructive/batch operations, so no cap applies.

5 / 5

Progressive Disclosure

The single bundle reference is well handled: the Brand Voice section links to references/brand-voice.md with a clear description of its contents ("extraction steps, a worked profile, before/after examples, and per-person voice guides"), the file exists, and it is exactly one level deep. However, the ~320-line body keeps sizable content inline that could arguably live in references (the ~40-line Maintaining Learnings policy, the full 14-section interview guide), so it fits the 4 anchor ("good structure; most content appropriately placed; minor organization gaps") better than the 5 anchor's "content appropriately split."

4 / 5

Total

18

/

20

Passed

Description

91%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 description that explicitly answers what the skill does and when to use it, with an extensive list of natural trigger phrases including synonyms and the canonical file path. The only minor weaknesses are a somewhat narrow action vocabulary (create/update) and mild overlap risk with dedicated positioning/brand-voice skills on a few broad triggers.

DimensionReasoningScore

Specificity

The description names concrete actions — "create or update their product marketing context document" and "creates `.agents/product-marketing.md` that all other skills reference for product, audience, and positioning context" — but the action set is limited to create/update rather than enumerating several distinct operations, so it sits between the 3 anchor ("names domain and 1-2 concrete actions") and the 5 anchor ("multiple specific concrete actions"). It clears 3 because the artifact, storage location, and content scope (product, audience, positioning) are all explicit, but never fully enumerates what the document captures, keeping it below 5.

4 / 5

Completeness

Both "what" and "when" are explicitly and concretely answered: what — a product marketing context document at `.agents/product-marketing.md` covering product, audience, and positioning; when — "When the user wants to create or update their product marketing context document," an explicit list of user phrases, and "Use this at the start of any new project before using other marketing skills." This mirrors the 5 anchor's example structure (statement of capability followed by "Use when..." with concrete trigger phrases).

5 / 5

Trigger Term Quality

Comprehensive natural-language triggers users would actually say: "positioning," "who is my target audience," "describe my product," "brand voice," "tone of voice," "what have we learned," "log this learning," plus synonyms ("ICP" and "ideal customer profile") and the exact file path `.agents/product-marketing.md`. This matches the 5 anchor ("comprehensive coverage of natural terms including synonyms and file extensions"); the volume and naturalness of phrasing exceed the 4 anchor's "a few natural terms missing."

5 / 5

Distinctiveness Conflict Risk

The skill carves a clear niche as the foundational context skill run "at the start of any new project before using other marketing skills," which distinguishes it from downstream drafting skills. However, broad trigger phrases like "positioning," "brand guidelines," and "tone of voice" could plausibly fire when a user intends a dedicated copywriting or brand-voice skill, so it does not reach the 5 anchor's "minimal conflict risk" — matching the 4 anchor's "minor overlap risk with closely related skills" instead.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

coreyhaines31/marketingskills

Path

skills/product-marketing/SKILL.md

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.