skills/comparative-research/SKILL.md
Use this skill whenever the user asks to evaluate, compare, or recommend between real-world options — devices, tools, vendors, services, platforms, or any category where the right choice depends on market data, specs, and target-user fit. Trigger on phrases like "recommend a...", "which X should I buy/use/choose", "compare these options", "find the best...", "top N choices for...", "compare these for me...", "comparative research for...", or any time the user needs a structured, evidence-backed selection decision. Use this skill even if the user's question seems quick or casual — e.g. "which phone should I get?" — because proper candidate selection requires a structured process to avoid bias. This skill is critical any time data availability might otherwise skew the recommendation toward well-documented options over better-fit options.
npx skillsauth add adnaanmhd/pretty-awesome-skills comparative-researchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A structured, bias-resistant process for evaluating options and producing a sourced, auditable recommendation.
Core failure mode this skill prevents: Recommending well-documented options over better-fit options because their spec sheets are easier to research. This skill forces primary criterion supremacy at every phase.
Before any research, extract and confirm all of the following. Do NOT proceed until the primary criterion is unambiguous — everything else flows from it.
| # | What to capture | Why it matters | |---|---|---| | 1 | Primary selection criterion — the single most important factor | Governs candidate selection in Phase 3. Cannot be overridden by data convenience. | | 2 | Hard constraints — pass/fail requirements every candidate must meet | Eliminates non-starters early | | 3 | Target user profile — who will actually use this, their behavior, geography, income, buying channels | Purchasing context often matters as much as specs | | 4 | Budget / price range — explicit bounds | Scopes the candidate pool | | 5 | Quantity and purpose — how many, and what role each serves (e.g. "worst-case stress test" vs. "realistic floor") | Determines how many winners to name and what roles they fill | | 6 | What does NOT matter — explicit noise elimination | Prevents irrelevant criteria from cluttering the analysis |
Run up to 3 research threads in parallel, each with a distinct focus:
| Thread | Focus | Sources | Output | |---|---|---|---| | Market | Market share, brand rankings, sales volumes, distribution channels, demographic penetration | Counterpoint, IDC, Canalys, Statista, GSMA | Forced-rank of all candidates by the PRIMARY criterion | | Specs | Technical specifications vs. hard constraints | GSMArena, official manufacturer pages, 91mobiles, Smartprix, product pages | Pass/fail table for every candidate | | User-fit | Target user behavior — how they buy, what they use, channel preferences, price sensitivity | Survey data, industry reports, news | Demographic alignment score per candidate |
⚠️ This is where most recommendation processes fail. Follow the sequence exactly.
Using ONLY the market/user-fit data from Phase 2, rank all potential candidates by the primary criterion. Write this ranking down before looking at spec completeness.
Remove candidates that fail pass/fail requirements. Document each elimination with a specific reason — this goes in the Eliminated Candidates section of the report.
For high-ranking candidates with incomplete spec data:
Anti-pattern to avoid:
"Option B has all specs on GSMArena, so I'll include it. Option A is missing FOV data, so I'll mention it as a backup."
This is wrong. If Option A ranks higher on the primary criterion, it goes in the top N with the FOV gap flagged. Option B's spec-sheet completeness is irrelevant to its ranking.
Before finalizing:
Define 10 or fewer criteria. For each:
Criteria ordering:
Anti-patterns to avoid:
For each candidate in the top N:
1. Spec table — assess every criterion with a status icon:
2. Sources — URLs for every claim
3. Strengths — 2–4 bullets, evidence-grounded
4. Weaknesses — 2–4 bullets, evidence-grounded. Never omit.
Single table, all candidates side by side, all criteria as rows, status icons throughout. Must be scannable in 30 seconds.
Surface every assumption and data gap as a scannable table. Never bury them in prose.
| # | Item | Status | |---|---|---| | 1 | Description of assumption or gap | Assumption / Risk — verify post-purchase / Known limitation / Trend to monitor |
Table mapping every source URL to what it was used for. Every claim in the report must be auditable from this index.
Save the report as a Markdown file with a descriptive filename (e.g. phone-recommendation-2024.md).
# [Title]
_Generated: YYYY-MM-DD_
---
## Context
## Evaluation Criteria (C1–C10)
## Eliminated Candidates
## Top N Candidates
## Comparison Matrix
## Recommendation
## Verification Checklist
## Assumptions & Gaps
## Sources Index
| # | Rule | |---|---| | 1 | Primary criterion supremacy. Data availability, research convenience, and spec-sheet completeness are never selection criteria — they are verification risks to flag. | | 2 | No unsourced claims. Every stat, market share figure, and spec needs a source URL. If unavailable: "no data available." Never fabricate. | | 3 | Assumptions are first-class outputs. Every inference, proxy, and gap gets surfaced in the Assumptions table with the phrase "This is an assumption." | | 4 | Diversity over convenience. Prefer covering different brands/categories over doubling up on whichever option has more available data. | | 5 | Installed base ≠ new sales. Always distinguish and report both when available. | | 6 | Distribution channels matter. How and where the target user purchases is as important as what they purchase. | | 7 | Confirm roles before recommending. If multiple items are needed (e.g. worst-case + realistic floor), confirm which role each pick serves — don't just assert it. |
testing
Design and document bespoke, high-quality user journeys for digital products. Use this skill whenever the user wants to map out, critique, redesign, or create a user journey, onboarding flow, feature walkthrough, or any end-to-end experience within an app or product. Trigger on phrases like "design the user journey", "map out the onboarding", "how should the user flow work", "create a journey for", "user journey for [feature/persona]", "review my onboarding flow", "what's the ideal journey for", or any time a user wants to think through how a person moves through a product — from first touch to repeated value. Also trigger when the user is working on retention flows, activation steps, aha moments, or progressive disclosure design.
research
Help users run effective customer discovery conversations and extract actionable insights. Use when someone is preparing for user research, planning discovery interviews, writing interview questions, analyzing findings, validating problems, understanding customer behavior, or trying to learn what customers actually want. Triggers include mentions of "customer interviews", "user research", "discovery calls", "talking to customers", "validating ideas", "customer conversations", "problem validation", or questions about what to ask customers.
testing
When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," or "CTA copy." For email copy, see email-sequence. For popup copy, see popup-cro.
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.