CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-decision-room

Turn messy user research notes, interviews, support tickets, surveys, and product context into an evidence-backed decision room: a single HTML artifact with an evidence ledger, theme map, confidence heatmap, opportunity matrix, decision memo, and experiment queue. Use when teams need to move from qualitative signals to product or design decisions without fabricating certainty.

69

Quality

87%

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

82%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 well-structured, highly actionable skill body with a clear seven-step workflow, concrete field-level guidance, and correctly signaled one-level-deep references verified to exist. The gaps are minor: a dangling `example.html` entry in the resource map, no explicit fix-and-re-check loop after the checklist step, and light redundancy with the frontmatter description.

Suggestions

Remove `example.html` from the resource map (or add the file), since the bundle only contains SKILL.md and references/ — a listed-but-missing file undermines the resource map's reliability.

In Step 7, add an explicit feedback loop: if any P0 checklist item fails, fix the artifact and re-run the checklist before emitting, mirroring the validate-fix-retry pattern.

Trim the opening framing paragraph and the 'When to use this skill' trigger list, which largely restate the frontmatter description and could be condensed to a single scope statement.

DimensionReasoningScore

Conciseness

The body is dense and instructional with no explanation of concepts Claude already knows, but the framing paragraph ("The output is not a decorative research deck. It is a working room for debate") and the "When to use this skill" section restate information already in the frontmatter description — minor instances that could be trimmed, so anchor 4 rather than the every-token-earns-its-place of anchor 5.

4 / 5

Actionability

Fully executable guidance for an instruction-only skill: exact ledger row fields (`id`, `source_type`, `segment`, `signal`, `quote_or_metric`, `strength`, `limitations`), enumerated source types, a fixed 8-section artifact information architecture, defined 1-to-5 scoring dimensions, and a copy-paste-ready `<artifact>` emission template with a defined stopping point ("Nothing after the closing `</artifact>`").

5 / 5

Workflow Clarity

Seven clearly sequenced steps with an explicit validation checkpoint ("Run the checklist. Then emit") and strong anti-fabrication rules, but the failure path is only implied — the anchor-5 pattern expects an explicit "if the checklist fails, fix and re-run" feedback loop rather than just a single pre-emit check.

4 / 5

Progressive Disclosure

References are well signaled at the right workflow moments ("Read `references/evidence-model.md` before synthesis and run `references/checklist.md` before emitting") and both files exist one level deep. However, the resource map lists `example.html`, which does not exist in the bundle — a dangling entry that keeps this below anchor 5.

4 / 5

Total

17

/

20

Passed

Description

88%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 that states concrete inputs, a specific multi-component HTML output, and an explicit "Use when..." clause with natural trigger phrasing. The only weaknesses are a few missing natural trigger synonyms and minor overlap risk with adjacent dashboard/dataviz skills.

DimensionReasoningScore

Specificity

The description names multiple concrete inputs ("research notes, interviews, support tickets, surveys") and six specific output components ("evidence ledger, theme map, confidence heatmap, opportunity matrix, decision memo, and experiment queue") — comprehensive coverage with no gaps, matching the anchor-5 example's level of specificity.

5 / 5

Completeness

Explicitly answers both questions: the "what" is turning inputs into "a single HTML artifact with an evidence ledger, theme map, confidence heatmap, opportunity matrix, decision memo, and experiment queue", and the "when" is stated verbatim as "Use when teams need to move from qualitative signals to product or design decisions without fabricating certainty" — concrete trigger phrasing present.

5 / 5

Trigger Term Quality

Good natural-phrase coverage ("user research notes", "interviews", "support tickets", "surveys", "qualitative signals") that users would actually say, but common variations like "usability test", "research findings", or "NPS comments" are absent from the description itself. Not 3 because coverage is clearly good rather than partial; not 5 because several natural synonyms are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and distinctive ("evidence-backed decision room", "without fabricating certainty"), but output language like "confidence heatmap" and survey/qualitative phrasing overlaps slightly with general data-visualization and research-reporting skills. Mostly distinct with minor overlap risk — anchor 4 rather than 5.

4 / 5

Total

18

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

nexu-io/open-design

Path

skills/research-decision-room/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.