CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

product-skills

Use when coordinating product work across the 12 bundled product sub-skills (RICE, OKRs, UX research, design tokens, competitive teardown, analytics, experiments, discovery, roadmaps, spec-to-repo, landing pages, SaaS scaffolding) or the 4 standalone product-team plugins (user stories, Apple HIG, code-to-PRD, research summarizer). Triggers on 'help me prioritize', 'plan a product experiment', 'we ship features nobody uses', 'run the discovery loop', 'is our OST sound'. Forks context to route to one sub-skill via a deterministic signal router and returns a digest; can also drive a continuous-discovery loop (Torres cadence tracker + OST linter as machine gates) or a full goal→plan→execute→verify→close run through the repo-wide agent-harness. Distinct from project-management (how to deliver vs what to build), marketing/landing (from-scratch pages), and engineering/agent-harness (the generic loop engine this orchestrator plugs into).

76

Quality

95%

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

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

An exceptionally well-engineered orchestrator skill: deterministic routing with exit-code semantics, a bounded discovery loop with machine gates and explicit stop states, and textbook progressive disclosure verified against the actual bundle. The only weakness is redundancy between the Hard rules, Anti-patterns, and Non-goals sections, which restate the same constraints.

Suggestions

Merge the Anti-patterns section into the Hard rules (e.g. '❌ Cite an OST that fails the linter' restates rule 1, 'Let the discovery streak die silently' restates the DORMANT escalation) to reclaim ~10 lines of token budget.

Trim the Non-goals section to a one-line pointer — its project-management / marketing / agent-harness boundaries are already stated verbatim in the frontmatter description.

The terminal 'Loop vocabulary: loop-library' reference gives no resolvable path; either give it a concrete path like the agent-harness pointer or drop it.

DimensionReasoningScore

Conciseness

The body is dense and assumes domain competence (names RICE, WSJF, JTBD, OST without explaining them), but the 'Hard rules' and 'Anti-patterns' sections state the same rules twice (OST-lint gating, silent discovery death, RICE-as-only-lens), and 'Non-goals' repeats the frontmatter's distinctness boundaries. This matches 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Every workflow ships copy-paste-ready commands whose flags match the bundled scripts (e.g. `python3 scripts/product_goal_router.py --text "<the goal>" --output json`, `discovery_cadence_tracker.py --input discovery_log.json`), with behaviorally specified exit codes ('Exit 2 → ask ONE clarifying question', 'exit 2 = NEEDS-REWORK, fix before citing the tree') and sample data shapes in assets/. Fully executable guidance covering the common routing, loop, and harness cases.

5 / 5

Workflow Clarity

The discovery loop is a clearly sequenced 5-step process (Observe → Choose → Act → Verify → Record/Repeat-or-stop) with machine-checkable validation gates at explicit thresholds (cadence tracker refuses on < 2 interviews / exit 5; OST linter exit 2 = NEEDS-REWORK), feedback loops ('fix before citing the tree'), and explicit stop states with named escalation ('DORMANT for 4+ weeks → escalate to the product lead by name').

5 / 5

Progressive Disclosure

SKILL.md is a genuine overview: three reference files (continuous_discovery_canon.md, product_operating_model.md, ai_product_evals.md) all exist in the bundle, are one level deep (external URLs only, no nested references), and are signaled both at point of use in the Hard rules and in a dedicated References section with one-line descriptions. Data shapes are externalized to assets/ and logic to scripts/, keeping the body navigable.

5 / 5

Total

19

/

20

Passed

Description

100%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 model description: it names concrete capabilities in third person, gives explicit 'Use when' guidance with quoted natural trigger phrases, enumerates all 16 lanes it coordinates, and ends with reasoned distinctness boundaries against the three neighboring skills it could be confused with. No vague or padded language despite its length.

DimensionReasoningScore

Specificity

Multiple specific concrete actions with comprehensive coverage: 'Forks context to route to one sub-skill via a deterministic signal router and returns a digest', 'drive a continuous-discovery loop (Torres cadence tracker + OST linter as machine gates)', and 'a full goal→plan→execute→verify→close run through the repo-wide agent-harness', plus enumeration of all 16 lanes (RICE, OKRs, UX research, design tokens, …). No capability gaps; anchor 4's 'minor gaps in coverage' does not apply.

5 / 5

Completeness

Explicitly answers both questions: 'Use when coordinating product work across the 12 bundled product sub-skills … or the 4 standalone product-team plugins' plus 'Triggers on …' for when, and 'Forks context to route to one sub-skill … returns a digest; can also drive a continuous-discovery loop … or a full goal→plan→execute→verify→close run' for what. Both what and when are concrete and explicit.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases a user would actually say — 'help me prioritize', 'plan a product experiment', 'we ship features nobody uses', 'run the discovery loop', 'is our OST sound' — plus comprehensive keyword enumeration including synonyms across all 16 lanes (e.g. 'landing pages' and 'SaaS scaffolding'; 'discovery' and 'continuous-discovery loop'). Matches the comprehensive-coverage anchor, not the few-terms-missing anchor.

5 / 5

Distinctiveness Conflict Risk

The description closes with explicit disambiguation: 'Distinct from project-management (how to deliver vs what to build), marketing/landing (from-scratch pages), and engineering/agent-harness (the generic loop engine this orchestrator plugs into)'. A clear niche (product-domain orchestration) with distinct triggers and reasoned boundary statements — minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

product-team/skills/product-skills/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.