first-glance

Evaluate readability and cognitive load of developer-facing artifacts.

6|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/markacianfrani/armor --skill first-glance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: first-glance
Source: https://github.com/markacianfrani/armor/tree/main/skills/first-glance
Command: npx skills add https://github.com/markacianfrani/armor --skill first-glance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of poor developer experience (DX) by identifying immediate friction points in documentation, error messages, and API surfaces that cause users to disengage within the first five seconds.

Core Features & Use Cases

  • First Impression Audit: Simulates a stranger's initial gaze to determine if the core value proposition is immediately visible.
  • Repulsion Detection: Pinpoints specific elements like wall-of-text parameters or cryptic abbreviations that drive users away.
  • Use Case: Use this skill when reviewing a new README or a complex CLI help output to ensure the most critical information is prioritized for the reader's first fixation.

Quick Start

Ask the AI to perform a first glance review on the provided README file to identify potential readability improvements.

Frequently Asked Questions about first-glance

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

FAQPage Schema
How do I audit the readability of a README file?

Analyze developer experience friction by identifying poor visual hierarchy and information density in CLI interfaces. This reveals primary cognitive fixations and repulsion points like wall-of-text parameters that drive users away during their first five seconds of interaction.

What causes poor developer experience in documentation?

Poor developer experience is caused by immediate friction points like cryptic abbreviations and walls of text. These elements increase cognitive load and cause users to disengage from documentation or error messages within the first five seconds of interaction.

How do I check if my API surfaces are clear for new users?

Check API surface clarity by performing a first impression audit that simulates a stranger's initial gaze. This evaluates whether the core value proposition is immediately visible and identifies specific elements causing high cognitive load.

Can I use this to review complex CLI help output?

Yes, you can review complex CLI help output to ensure critical information is prioritized for the reader's first fixation. It targets the first five seconds of interaction to pinpoint repulsive elements like cryptic abbreviations that drive users away.

What is a first glance review for developer-facing artifacts?

A first glance review is an objective assessment of visual hierarchy and information density for developer-facing artifacts. It simulates the first five seconds of user interaction to identify primary fixations and improve overall developer experience.