# Search Result Presentation

> Present results so a user can judge relevance without opening each one, with useful snippets, clear grouping, and honest metadata. Use when results are correct but users still cannot find what they need.

- Skill: `amey-thakur/search-result-presentation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add amey-thakur/search-result-presentation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/amey-thakur/search-result-presentation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Amey-Thakur (https://skillmd.com/u/amey-thakur)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/amey-thakur/search-result-presentation

---


# Search result presentation

Ranking decides what is on the page; presentation decides whether the
user recognises it. A correct first result that looks like every other
row still costs the user time, and that time is what search was supposed
to save.

## Method

1. **Show why each result matched.** A snippet containing the query
   terms in context, with the match highlighted, lets a user judge at a
   glance rather than by clicking.
2. **Lead with the field people scan.** Usually a title, sometimes an
   identifier or a name. A snippet-first layout wastes the strongest
   signal.
3. **Include the metadata that decides.** Date, type, author, status, or
   price, chosen because it is what people compare, not because it is
   available.
4. **Group when results come from different sources.** Mixing documents,
   people, and settings in one flat list forces the user to sort the
   categories mentally.
5. **Make the whole result actionable.** A large click target, keyboard
   navigable, with the primary action obvious (see keyboard-navigation).
6. **Keep pagination or infinite scroll honest.** Show how many results
   exist, keep positions stable across loads, and preserve state when
   the user returns from a result.
7. **Handle long and empty fields gracefully.** Truncate at a sensible
   boundary with the query term still visible, and never show a blank
   row for missing data (see text-expansion-layout).

## Boundaries

- Presentation helps users recognise relevance; it cannot compensate
  for a poor ranking (see relevance-tuning).
- Highlighting must not alter the underlying text or introduce markup
  the user did not write, which is an injection risk.
- Dense information layouts need accessibility review, since scannable
  and screen-reader friendly are not automatically the same (see
  screen-reader-testing).