CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

talk-stoneham-product-brain

Explains the Product Brain talk and helps design curated product-memory systems for AI-assisted product work: knowledge structure, provenance, synthesis cadence, ownership, and agent-ready context packets. Use when the user asks about product context for AI, product knowledge management, product documentation for LLMs, or building a maintained product brain.

Quality

81%

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

71%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 lean, well-structured instruction-only skill with concrete workflows, output templates, and example response shapes that make the guidance mostly executable. Its main weaknesses are a dangling set of bundle references (outline.md, quote.md, transcript.md are absent), repeated redaction guidance, and design steps that stop short of concrete examples.

Suggestions

Ship the referenced bundle files (outline.md, quote.md, transcript.md) in a references/ directory and update the Read Order paths to include that prefix, so the one-level-deep navigation actually resolves.

Consolidate the redaction rule, which currently appears in Read Order item 4, the closing Core Workflow paragraph, and the Redacted Request template, into a single authoritative statement plus the response template.

Add example curated knowledge categories and a filled-in context packet instance so 'Choose a small set of curated knowledge categories' and 'Create agent-ready packets' have concrete models to follow.

DimensionReasoningScore

Conciseness

The body is lean and imperative ('Record provenance and owner for each category', 'Answer in 2-5 sentences') and assumes Claude's competence throughout. Not 5 because the redaction rule is stated three times (Read Order item 4, the closing Core Workflow paragraph, and the Redacted Request template) and could be consolidated into one.

4 / 5

Actionability

For an instruction-only skill, guidance is mostly executable: numbered workflows, concrete output-template skeletons with named fields (Goal, Boundaries, Review points, Evidence, Open questions), and worked example response shapes. Not 5 because steps like 'Choose a small set of curated knowledge categories' lack example categories, and the workflows depend on outline.md/quote.md files whose contents are unavailable.

4 / 5

Workflow Clarity

Each workflow is a clearly numbered sequence with unambiguous steps, and the factual-question workflow includes a coverage check ('State when the bundle does not cover a requested detail'). Not 5 because the workflows lack any verification step (e.g., confirming a designed packet passes its own review gates), though no destructive or batch operation triggers the score-3 cap.

4 / 5

Progressive Disclosure

Read Order cleanly signals one-level-deep references (outline.md, quote.md, transcript.md), but none of these files exist in the bundle (no references/ directory), and the paths carry no directory prefix, so navigation cannot be resolved. The body's own section structure is good, but the referenced structure cannot be verified, leaving organization incomplete.

3 / 5

Total

15

/

20

Passed

Description

83%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 with a clear what-and-when structure and concrete trigger phrases closely matching the top anchor for completeness. Specificity and trigger coverage are solid with only minor gaps (the unexplained 'Product Brain talk' reference and a few missing synonyms).

DimensionReasoningScore

Specificity

Lists several specific capabilities — 'helps design curated product-memory systems' with enumerated components ('knowledge structure, provenance, synthesis cadence, ownership, and agent-ready context packets') — in third person. Not 5 because 'Explains the Product Brain talk' assumes context about which talk, leaving a minor gap in what is actually explained.

4 / 5

Completeness

Clearly answers both what ('Explains the Product Brain talk and helps design curated product-memory systems...') and when, with an explicit 'Use when the user asks about...' clause listing four concrete trigger scenarios. Matches the 5 anchor's structure exactly.

5 / 5

Trigger Term Quality

Good natural trigger phrases: 'product context for AI', 'product knowledge management', 'product documentation for LLMs', 'building a maintained product brain'. Not 5 because common synonyms like 'product memory' or 'context for agents' are missing, though coverage is otherwise strong.

4 / 5

Distinctiveness Conflict Risk

The 'product brain' / product-memory-for-AI niche is distinct with dedicated triggers ('building a maintained product brain'). Not 5 because 'product documentation' phrasing creates minor overlap risk with general documentation skills.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Plugins/aidevcon/skills/talk-stoneham-product-brain/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.