CtrlK
BlogDocsLog inGet started
Tessl Logo

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).

74

Quality

93%

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

The canonical home for this skill is product-skills in alirezarezvani/claude-skills

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 strong orchestrator body: routing and loop workflows are gated by executable scripts with explicit exit-code semantics, and every rule is checkable. The main costs are mild redundancy between the Hard rules and Anti-patterns sections, an inlined forcing-question library that could live in a reference, and referenced bundle paths that are not present in the skill directory to verify.

Suggestions

Deduplicate guidance repeated across sections — the single-participant-anecdote rule and the DORMANT-escalation rule each appear in both Hard rules and Anti-patterns; state each once and cross-reference.

Move the six-entry forcing-question library (with its canon citations) into a reference file (e.g. references/forcing_questions.md) and keep one lane-defining example per lane in SKILL.md to reduce inline token cost.

Ship the referenced bundle files (scripts/product_goal_router.py, scripts/discovery_cadence_tracker.py, scripts/ost_linter.py, the three references/*.md, assets/sample_discovery_log.json) alongside SKILL.md so the one-level-deep reference structure actually resolves.

DimensionReasoningScore

Conciseness

The body is dense and mostly assumes competence (exit-code tables, command blocks, terse rules), but there is some redundancy that could be trimmed: "no insight is asserted from a single participant (anecdote, not insight)" reappears in Anti-patterns ("promote a single-participant anecdote to insight"), as does "DORMANT escalates by name" / "escalate to the product lead by name", and the six-entry forcing-question library with full canon citations is verbose for inline placement. This sits between level 4 (efficient, minor instances that could be trimmed) and level 5 (every token earns its place) — noticeably above the midpoint but not flawless, so 4.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with arguments and interpreted exit codes: `python3 scripts/product_goal_router.py --text "<the goal>" --output json` (exit 0/2/3 behaviors spelled out), `python3 scripts/discovery_cadence_tracker.py --input discovery_log.json` (exit 5 refusal), `python3 scripts/ost_linter.py --input ost.json` (exit 2 = NEEDS-REWORK), and the full goal_compiler invocation with --manifest and --out. This matches level 5 (fully executable commands covering the common cases); level 4 would require missing key details, and even log shapes are surfaced via "every tool ships --sample" and the assets sample path.

5 / 5

Workflow Clarity

Both multi-step processes have clear sequences with machine-checkable validation gates and feedback loops: routing branches on exit codes (0 → load skill, 2 → ask one clarifying question, 3 → restate, "Never guess silently"), and the discovery loop is five numbered steps with lint-before-cite enforcement ("exit 2 = NEEDS-REWORK, fix before citing the tree"), explicit stop states, and named escalation. This matches level 5 (clear sequence, explicit validation steps, feedback loops, checklists).

5 / 5

Progressive Disclosure

Structure is good: three clearly signaled one-level-deep references in a References section (continuous_discovery_canon.md, product_operating_model.md, ai_product_evals.md) plus inline pointers to scripts and an assets sample, and the When-to-invoke table delegates detail to the sub-skills. However, no bundle files (references/, scripts/, assets/) are present in the skill directory, so the referenced paths cannot be verified, and substantial content (the forcing-question library with citations, the full hard-rules detail) is inlined where an orchestrator overview could push it one level down — matching level 4 (good structure, references mostly clear, minor organization gaps) rather than level 5.

4 / 5

Total

18

/

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.

An unusually well-crafted description: it states the orchestrator's concrete capabilities, gives five natural-language trigger phrases plus a full keyword inventory, answers both what and when explicitly, and closes with explicit boundaries against three neighboring skills. No padding or over-claims are present despite the length.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "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)", "a full goal→plan→execute→verify→close run through the repo-wide agent-harness" — and names all 16 coordinated skills. This matches the level-5 anchor (multiple specific concrete actions, comprehensive coverage); level 4 would require a noticeable coverage gap, and none exists.

5 / 5

Completeness

Both questions are explicitly answered: what ("coordinating product work across the 12 bundled product sub-skills ... route to one sub-skill via a deterministic signal router and returns a digest") and when ("Use when coordinating product work across ..." plus five concrete trigger phrases). This matches level 5 (clear, explicit what AND when with concrete trigger phrases); the cap of 3 for a missing 'Use when' clause does not apply.

5 / 5

Trigger Term Quality

It quotes natural user phrasings — "'help me prioritize'", "'plan a product experiment'", "'we ship features nobody uses'", "'run the discovery loop'", "'is our OST sound'" — on top of a near-exhaustive domain keyword list (RICE, OKRs, UX research, design tokens, competitive teardown, analytics, experiments, discovery, roadmaps, spec-to-repo, landing pages, SaaS scaffolding). This is comprehensive coverage of natural terms with synonyms, matching level 5; level 4 requires a few natural terms to be missing, and the quoted triggers plus keyword list cover the domain's vocabulary.

5 / 5

Distinctiveness Conflict Risk

A clear niche (product-domain orchestrator and router) is stated with explicit demarcation from adjacent skills: "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)". Overlap with its own 16 sub-skills is by design (routing to them is the skill's purpose), so conflict risk is minimal — matching level 5.

5 / 5

Total

20

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 15 missing

Warning

Total

13

/

16

Passed

Repository
alirezarezvani/claude-skills
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.