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,' 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-context.md` that all other skills reference for product, audience, and positioning context.
86
83%
Does it follow best practices?
Impact
87%
3.48xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description with excellent trigger term coverage and clear completeness, explicitly stating both what the skill does and when to use it. The main weakness is that the 'what' portion could be more specific about the concrete actions involved (e.g., gathering product details, defining ICPs, establishing positioning frameworks) rather than just 'create or update' a document. Overall, it would perform well in a multi-skill selection scenario.
Suggestions
Add more specific concrete actions beyond 'create or update' — e.g., 'Gathers product details, defines ideal customer profiles, establishes positioning and messaging frameworks, and saves them to .agents/product-marketing-context.md.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (product marketing context) and mentions creating/updating a context document, but the concrete actions are limited to 'create or update' a single file. It doesn't list multiple distinct concrete actions beyond that. | 2 / 3 |
Completeness | Clearly answers both 'what' (creates/updates `.agents/product-marketing-context.md` containing product, audience, and positioning context) and 'when' (explicit 'Use when' triggers and guidance to use at the start of new projects before other marketing skills). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'product context,' 'marketing context,' 'set up context,' 'positioning,' 'who is my target audience,' 'describe my product,' 'ICP,' 'ideal customer profile.' These are terms users would naturally say when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — it targets a specific niche (foundational product marketing context setup), references a specific file path, and clearly differentiates itself as a prerequisite step before other marketing skills. Unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%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-crafted skill with excellent actionability and workflow clarity — it provides a complete template, clear branching logic, and explicit validation steps throughout. Its main weakness is length: the inline 12-section detail and full output template make it verbose for a single SKILL.md file, and some explanatory text could be trimmed. The content would benefit from splitting the detailed section definitions or output template into a referenced file.
Suggestions
Move the full output markdown template and/or the detailed 12-section definitions into a referenced file (e.g., TEMPLATE.md or SECTIONS.md) to reduce the main skill's token footprint.
Trim explanatory asides like 'exact phrases are more valuable than polished descriptions because they reflect how customers actually think and speak' — Claude understands why verbatim language matters.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~200+ lines) with some sections that could be tightened. However, much of the content is structural templates and section definitions that earn their place. Some explanatory text like 'exact phrases are more valuable than polished descriptions because they reflect how customers actually think and speak, which makes copy more resonant' over-explains things Claude would understand. The competitive landscape examples (Calendly vs SavvyCal) add useful clarity but the overall document could be more compact. | 2 / 3 |
Actionability | The skill provides a complete, copy-paste-ready markdown template for the output document, specific file paths (.agents/product-marketing-context.md), concrete questions to ask, a clear two-option workflow (auto-draft vs scratch), and specific examples of good vs bad questions ('What's the #1 frustration?' vs 'What problem do they solve?'). The guidance is highly concrete and executable. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced in 4 numbered steps with explicit branching logic (exists vs doesn't exist, auto-draft vs scratch). Each step has clear validation checkpoints — checking for existing files, confirming accuracy per section, showing the completed document before saving, and asking for adjustments. The feedback loop of 'present draft → ask what needs correcting → iterate until satisfied' is explicit. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear headers and sections, but it's monolithic — the full 12-section detail and the complete output template are all inline. The sections-to-capture detail and the markdown template could reasonably be split into referenced files, especially since this skill is quite long. However, the organization within the single file is logical and navigable. | 2 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
2c7c108
Table of Contents
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.