Agent skill

Expectation Effect

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Apply the Expectation Effect — the principle that prior expectations measurably change a person's perception of a product or experience.

Apache-2.0Auto-check passedFrontend & Design

Install Expectation Effect

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill expectation-effect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins expectation-effect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/HDeibler/universal-design-principles/plugins/interaction-and-control-principles/skills/expectation-effect .claude/skills/expectation-effect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
expectation-effect
GitHub stars
1.2k
Token cost
~2.6k tokens
SKILL.md length
1,389 words
Files
2 (incl. references)
Skills in repo
736
Repo updated
First seen
Licence
Apache-2.0

At a glance

Apply the Expectation Effect — the principle that prior expectations measurably change a person's perception of a product or experience.

  • Shaping the framing of new features
  • SKILL.md covers Why this matters for design, The three tiers of expectation, The placebo and nocebo dynamics and Setting expectations honestly, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Designing onboarding

What it does

Expectation Effect is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the Expectation Effect — the principle that prior expectations measurably change a person's perception of a product or experience. Use when shaping the framing of new features, designing onboarding, choosing visual cues that signal premium vs. budget, or diagnosing why two functionally identical features feel different to users. Expectations are set by visual cues (premium materials, polished typography), language (precise, confident copy), social proof, price, and prior brand exposure. Setting expectations…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/lineage.md`).

It sits in Frontend & Design, covering Marketing psychology and Typography. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Shaping the framing of new features
  • Designing onboarding
  • Choosing visual cues that signal premium vs

Example prompts

  • “/expectation-effect”

What it can do on your machine

Read from SKILL.md and the folder at commit 16b4156. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Expectation Effect loads about 2.6k tokens when it runs, and up to ~4.8k if it reads all its reference files. Until then it costs about 164 tokens; SKILL.md has 1,389 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~164
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its Apache-2.0 licence (© hashgraph-online). 1,389 words, ~2,584 tokens.

Download SKILL.mdSave it as .claude/skills/expectation-effect/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
expectation-effect
description
Apply the Expectation Effect — the principle that prior expectations measurably change a person's perception of a product or experience. Use when shaping the framing of new features, designing onboarding, choosing visual cues that signal premium vs. budget, or diagnosing why two functionally identical features feel different to users. Expectations are set by visual cues (premium materials, polished typography), language (precise, confident copy), social proof, price, and prior brand exposure. Setting expectations too high creates disappointment; too low and the product reads as mediocre. The skill is calibrating what to promise.

Expectation Effect

Definition. The Expectation Effect is the well-established phenomenon that what people expect from a product, service, or experience changes how they actually perceive and evaluate it. Two functionally identical things will be experienced differently if the expectations going in differ. The same wine tastes better when poured from an expensive-looking bottle. The same painkiller works more effectively when patients are told it's a brand name. The same software feels faster when its loading animation looks confident.

This is one of the most thoroughly documented phenomena in cognitive psychology, marketing research, and clinical medicine. The effect is real, robust, and operates outside conscious awareness — users genuinely perceive the higher-expectation version as better, not because they're rationalizing but because their perceptual system is shaped by their prior expectations.

Why this matters for design

The expectation effect is double-edged. Used well, it amplifies the perceived quality of your work — a polished onboarding flow makes the rest of the app feel polished too; a confident loading animation makes the loading time feel shorter; a premium brand makes the same feature feel more refined. Used poorly, it creates a perception–reality gap that punishes you in two ways: either expectations exceed reality and users feel cheated (the dreaded "looked great in the marketing, disappointing in use" experience), or expectations undersell reality and users dismiss the product before discovering its strengths.

Most design discussions focus on the thing being designed — the buttons, layouts, flows. The expectation effect insists you also design what comes before the thing — the framing, the marketing, the first-screen impression, the price tag, the brand context. These shape how the thing itself will be perceived.

The three tiers of expectation

Expectations are set in three layers, in roughly the order users encounter them.

1. Pre-encounter expectations. Before the user touches the product, expectations are set by branding, marketing, price, recommendations, prior reputation, and category convention. A user opening a $40/month enterprise tool expects a different experience than one opening a free utility. A user who arrived through a friend's recommendation expects something different from one who arrived through a banner ad. These expectations are largely outside the product itself but shape the entire first session.

2. Surface expectations — set in the first 5 seconds. Visual polish, typography quality, animation smoothness, color choices, copy tone — all of these set expectations almost instantly. A user who opens an app and sees default system fonts, awkward spacing, and inconsistent margins immediately downshifts their expectations of how the rest of the experience will feel. A user who opens an app with confident typography, intentional whitespace, and a single moment of delight (a smooth transition, a charming empty state) immediately upshifts their expectations.

3. Performance expectations — set during the first interaction. Speed, responsiveness, the smoothness of the first action, the clarity of the first feedback — these set expectations for everything that follows. A first interaction that feels fast and confident creates a halo effect that makes later (slower) interactions feel acceptable. A first interaction that feels slow or clumsy creates a negative halo that makes later (fast) interactions feel like surprises rather than the norm.

The placebo and nocebo dynamics

The clearest demonstration of the expectation effect comes from clinical pharmacology: the placebo effect. Patients given inert sugar pills, while told they are receiving an effective medication, frequently experience genuine symptom relief — measurable in physiological markers, not just self-reports. The effect is large enough that all rigorous drug trials must control for it.

The same dynamic appears in product perception. Users told a piece of software is "powered by AI" rate the same outputs as more impressive than users told the same outputs come from a "rule-based system." Users shown a higher price perceive the product as higher quality, even when the underlying product is identical. Users told a wine is from a famous vineyard taste it as more complex.

The flip side is the nocebo effect. Users primed to expect poor performance perceive even good performance as poor. A reputation for being slow makes the product feel slow even after it's been optimized. A first-impression failure casts a long shadow over later, fixed interactions.

Setting expectations honestly

The temptation, when you understand the expectation effect, is to manufacture expectations as high as possible: oversell the product, premium-up the visual style, claim more than the product delivers. This works for the first session and fails for everything after. Users whose expectations are set above what the product actually delivers leave with a stronger negative impression than users whose expectations were realistic from the start.

The skill is calibration. Expectations should be set just slightly above the median experience — high enough to attract attention and create the positive halo effect, low enough that the product reliably exceeds them in actual use. The Apple "unboxing" is a master class in this: the packaging promises premium, the device delivers premium, and the experience exceeds expectations even though expectations were already high.

The mechanisms for honest expectation-setting include: showing the actual product (not stylized renders) in marketing; being specific about what the product does and doesn't do; using language that matches the actual register of the product (don't write enterprise-sober copy if the product is playful); pricing in a band that matches the actual quality; and resisting feature-list inflation that promises more than the product delivers.

Show full SKILL.md (504 more words)Show less

When expectations and reality diverge

Two failure modes are worth knowing.

Premium framing on an unpolished product. Beautiful marketing, ambitious pricing, confident brand voice — and then the actual product has a default-typography settings panel, awkward error messages, and slow loading. The gap between the marketing-set expectations and the reality is more painful than if both had been more modest. Users feel deceived even when no specific deception occurred.

Apologetic framing on a strong product. Cautious marketing, low pricing, hedged language ("a simple tool for...") on a product that actually performs at a higher level. The product never gets evaluated against its real capability because users come in with low expectations and don't push it hard enough to discover what it can do. This is common with academic, indie, or non-profit products that under-frame their work.

The fix in both cases is to align the framing to the product. If the product is premium, frame it as premium and verify the surface lives up to it. If the product is plain but powerful, choose plain framing and let the work speak.

Sub-skills in this cluster

  • expectation-effect-priming — How prior context (brand, price, recommendations, marketing) shapes user perception, and how to set those priming signals deliberately.
  • expectation-effect-design-cues — How surface cues within the product itself (typography, animation, copy tone, micro-interactions) set in-session expectations and create halo effects.

Heuristic checklist

Before launching a feature or product, ask: What expectations are users arriving with? From the marketing, the price, the category, the previous version. Does the actual experience meet or exceed those expectations? Be specific about which moments confirm and which moments disappoint. If there's a gap, which side should move? Sometimes the fix is to upgrade the product; sometimes the fix is to lower the framing. What is the first 5-second impression? That impression sets a halo that persists through the session. What is the first interaction's performance and clarity? That sets the performance halo for every interaction after.

When the principle is misapplied

Manipulating expectations to increase short-term metrics — making things look more premium than they are, claiming features the product doesn't actually have, using social-proof copy that overstates adoption — works in the short run and backfires in the long run. The expectation effect amplifies both the experience and the disappointment when the experience falls short of what was promised. Sustained use of the principle requires honest calibration, not maximum amplification.

  • Aesthetic-Usability Effect — beautiful designs are perceived as more usable; this is one specific case of the expectation effect.
  • Anchoring — pricing or first-encountered values shape evaluation of subsequent values.
  • Mental Model — expectations are shaped by what the user thinks the system is.
  • Form Follows Function — when the product looks like what it does, expectations align naturally.
  • Mimicry — products that mimic premium category conventions inherit the expectations of that category.
  • Storytelling Arcs — the narrative around a product shapes the lens through which it's experienced.

See also

  • references/lineage.md — origins in placebo research, marketing studies, and HCI.
  • expectation-effect-priming/ — sub-skill on pre-encounter expectation setting.
  • expectation-effect-design-cues/ — sub-skill on in-session expectation cues.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/HDeibler/universal-design-principles/plugins/interaction-and-control-principles/skills/expectation-effect of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/lineage.md

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Expectation Effect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Expectation Effect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Expectation Effect this skillhashgraph-online/awesome-codex-plugins1.2k—~2.6kAutomated safety check: PassApache-2.0
Brand Guidelinescomposio-community/awesome-codex-skills17k—~617Automated safety check: PassApache-2.0
Brand Guidelines Anthropicaiskillstore/marketplace4304 repos~587Automated safety check: PassApache-2.0
Improve Websitewondelai/skills2.4k—~5.1kAutomated safety check: PassMIT
Influence Psychologywondelai/skills2.4k—~4.3kAutomated safety check: PassMIT
Landing Page Optimizerthatrebeccarae/claude-marketing162—~1.1kAutomated safety check: PassMIT

Similar skills

  • Brand Guidelines

    composio-community/awesome-codex-skills

    Applies OpenAI's brand colors and typography to any artifact that should match the Codex/OpenAI look-and-feel.

    17k GitHub stars~617 tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Brand Guidelines Anthropic

    aiskillstore/marketplace

    Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel.

    430 GitHub starsUsed in 4 repos~587 tokens
    Frontend & DesignAuto-check passed
  • Improve Website

    wondelai/skills

    Guided journey from a live website that underperforms to a prioritized, evidence-backed backlog of conversion, usability, message, and speed fixes - each shipped as a testable experiment.

    2.4k GitHub stars~5.1k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed
  • Influence Psychology

    wondelai/skills

    Apply the seven principles of ethical persuasion (reciprocity, commitment, social proof, authority, liking, scarcity, unity) to product design, copy, and sales.

    2.4k GitHub stars~4.3k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed
  • Landing Page Optimizer

    thatrebeccarae/claude-marketing

    Landing page audit and optimization for conversion. An agent skill from thatrebeccarae/claude-marketing.

    162 GitHub stars~1.1k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Create Website

    wondelai/skills

    Guided journey from a blank page to a live, high-converting website, built message-first, then design, then conversion.

    2.4k GitHub stars~5.7k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated yesterday
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed

Questions about Expectation Effect

What does Expectation Effect do?

Apply the Expectation Effect — the principle that prior expectations measurably change a person's perception of a product or experience. Expectation Effect is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the Expectation Effect — the principle that prior expectations measurably change a person's perception of a product or experience.

When should I use Expectation Effect?

Expectation Effect fits situations like: shaping the framing of new features; designing onboarding; choosing visual cues that signal premium vs.

How do I install Expectation Effect in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill expectation-effect -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/interaction-and-control-principles/skills/expectation-effect in hashgraph-online/awesome-codex-plugins) into .claude/skills/expectation-effect in your project. Claude Code loads it when a task matches its description.

How do I install Expectation Effect in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill expectation-effect -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/interaction-and-control-principles/skills/expectation-effect in hashgraph-online/awesome-codex-plugins) into .agents/skills/expectation-effect in your project. Codex loads it when a task matches its description.

Can I use Expectation Effect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill expectation-effect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/expectation-effect, .gemini/skills/expectation-effect, .github/skills/expectation-effect and .opencode/skills/expectation-effect in your project.

What does Expectation Effect need to run?

SKILL.md names no scripts, command-line tools or credentials: Expectation Effect is instructions for the agent only.

Does Expectation Effect access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Expectation Effect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Expectation Effect use?

Expectation Effect is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Expectation Effect use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Expectation Effect?

Skills that share tags, products or a category with Expectation Effect: Brand Guidelines (composio-community/awesome-codex-skills, 17k stars), Brand Guidelines Anthropic (aiskillstore/marketplace, 430 stars), Improve Website (wondelai/skills, 2.4k stars) and Influence Psychology (wondelai/skills, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Expectation Effect?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.