Name: product-marketing-context
Rating: 60.8 (1 reviews)
Author: administrakt0r

product-marketing-context

Create or update a reusable product marketing context document with positioning, audience, ICP, use cases, and messaging. Use at the start of a project to avoid repeating core marketing context across tasks.

Quality

71%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/product-marketing-context/SKILL.md

The canonical home for this skill is product-marketing-context in administrakt0r/AI-Agents-Safe-Coding-Skills

Quality

Content

67%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.

The skill body is a strong, actionable instruction set with a clear workflow and a ready-to-use template. The main drag is conciseness: a few explanatory passages and redundant framing could be trimmed to respect the context budget.

Suggestions

Tighten conciseness by removing explanatory justifications (e.g., the 'because they reflect how customers actually think and speak' clause) and de-duplicating the 'When to Use' list against the description.

Consider moving the large Step 3 document template into a references file (e.g. references/template.md) referenced one level deep, which would shorten SKILL.md and improve progressive_disclosure.

Make the auto-draft gathering step more concrete by listing the specific repo artifacts to read in priority order and what to extract from each, closing the minor actionability gap.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and well-structured, but contains unnecessary explanatory asides (e.g., 'because they reflect how customers actually think and speak, which makes copy more resonant') and the 'When to Use' section restates the description.	3 / 5
Actionability	Provides a fully fleshed-out, copy-paste-ready document template and concrete sample prompts ('What's the #1 frustration that brings them to you?'); as an instruction-only skill it is highly actionable with only minor gaps in the auto-draft gathering specifics.	4 / 5
Workflow Clarity	A clear four-step sequence (check existing, gather, create, confirm/save) with explicit confirm-and-iterate feedback loops; non-destructive so no validation cap applies, but a couple of checkpoints could be sharper.	4 / 5
Progressive Disclosure	Well-organized into clear headers with no bundle files to navigate; the ~90-line inline document template could arguably live in a reference file, but the content is cohesive and appropriately placed.	4 / 5
	Total	15 / 20 Passed

Description

75%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.

The description clearly conveys what the skill produces and when to use it, with concrete component terms that aid triggering. It is well above average but stops short of the top anchor because the action verbs are limited and the when-trigger is fairly generic.

Dimension	Reasoning	Score
Specificity	Names the domain ('product marketing context document') and lists several concrete components (positioning, audience, ICP, use cases, messaging), but the actual actions are limited to 'create or update'.	4 / 5
Completeness	Explicitly answers both what ('create or update a reusable product marketing context document...') and when ('Use at the start of a project...'), though the when-trigger is somewhat narrow and could be more explicit.	4 / 5
Trigger Term Quality	Includes natural marketing terms a user would say (positioning, audience, ICP, messaging, 'start of a project'), but a few common phrasings and synonyms are missing.	4 / 5
Distinctiveness Conflict Risk	'Product marketing context document' is a clear niche with distinct triggers, with only minor overlap risk against sibling 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: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills-claude/skills/product-marketing-context/SKILL.md
Commit: 57c135b

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