fresh-eyes

Simulate a first-time user walkthrough to identify usability friction and documentation gaps.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/Theycallmeholla/skills --skill fresh-eyes-theycallmeholla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fresh-eyes
Source: https://github.com/Theycallmeholla/skills/tree/main/skills/fresh-eyes
Command: npx skills add https://github.com/Theycallmeholla/skills --skill fresh-eyes-theycallmeholla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the curse of knowledge by simulating a genuine first-time user experience, identifying confusing UI, onboarding gaps, and unclear documentation that insiders can no longer perceive.

Core Features & Use Cases

  • Naive Walkthroughs: Simulates a user with zero context to test apps, websites, or codebases.
  • Confusion Ledger: Systematically logs every point of friction, expectation mismatch, and "obvious" question encountered during a session.
  • First-Contact Reporting: Generates a structured report detailing where a newcomer gets stuck and what questions they have.
  • Use Case: Use this before a public launch to identify why new users are dropping off during your sign-up flow or to audit a README for a new open-source library.

Quick Start

Use the fresh-eyes skill to perform a cold-read audit of the provided documentation and identify potential onboarding friction points.

Frequently Asked Questions about fresh-eyes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my onboarding flow for usability friction?

You can audit onboarding flow usability friction by simulating a first-time user experience to systematically log confusing UI elements, expectation mismatches, and navigation hurdles. This generates a structured report detailing where newcomers get stuck and what questions they have.

What is the curse of knowledge in product UX design?

The curse of knowledge in product UX design is the insider bias that prevents teams from perceiving confusing UI and unclear documentation. It occurs when experts lose the objective perspective needed to see onboarding friction encountered by naive users.

How do I test my technical documentation for first-time user experience gaps?

To test technical documentation for first-time user experience gaps, perform a cold-read audit using a persona-based, non-expert interaction model. This surfaces naive questions to identify where newcomers lack context and struggle with onboarding.

Can I use a naive walkthrough to find why new users drop off during sign-up?

Yes, you can use a naive walkthrough to find why new users drop off during sign-up by simulating a user with zero context. This systematically logs every point of friction and expectation mismatch encountered during the onboarding session.

What is the best way to identify usability friction before a public launch?

The best way to identify usability friction before a public launch is to simulate a first-time user experience to uncover hidden gaps. This approach counters insider bias by systematically logging confusion points and expectation mismatches across your product.

Does this usability audit approach work for both landing pages and codebases?

Yes, this usability audit approach works for both landing pages and codebases. It applies a strict persona-based, non-expert interaction model to surface naive questions and navigation hurdles across onboarding flows and technical documentation.