Security

ergo-desk-calibrator

Try it

Use when setting up or fixing a home-office/desk workstation (new desk, new chair, aching neck/wrists by 3 PM, standing-desk height question) — computes your personal chair/monitor/desk numbers from body height with anthropometric proportions (seat 0.26H, desk 0.415H, seated eye 0.674H, standing elbow 0.63H), checks any monitor size for height/distance compliance, gives the laptop-compromise protocol (riser + external keyboard), maps your specific pain (neck/shoulder/wrist/eye/lower-back) to ranked likely causes with fixes, and prints the posture self-audit + 20-20-20 eye schedule.

What it does

Overview Almost every home desk is wrong in the same direction: the desk is too high for the person (75 cm "standard" suits ~185 cm people — everyone shorter hunches shoulders), the monitor sits 10-20 cm below eye line (neck flexion), and the laptop is used flat on the desk (worst of all worlds). T…

The skill document

Ergo Desk Calibrator

Overview

Almost every home desk is wrong in the same direction: the desk is too high for the person (75 cm "standard" suits ~185 cm people — everyone shorter hunches shoulders), the monitor sits 10-20 cm below eye line (neck flexion), and the laptop is used flat on the desk (worst of all worlds). The result shows up as the 3 PM neck ache, wrist tingles, and eye fatigue that people blame on "too much computer" when it's a geometry problem with exact numbers.

This skill computes YOUR numbers from your height using standard anthropometric proportions, then checks your setup against them:

  1. calibrate — height → seat height, desk height, monitor top-edge height above floor AND above desk, viewing distance, lumbar support point, keyboard slope. Standing-desk variant included.
  2. monitor — any screen size: does its top edge land at/below your eye line on your desk? Riser cm needed.
  3. laptop — the laptop compromise protocol (laptop screen + built-in keyboard is unsolvable; riser + external keyboard is).
  4. symptom — pain → ranked likely causes → exact fixes.
  5. checklist — 12-point posture self-audit + 20-20-20 eye rule schedule.

Pure stdlib, offline. Guidance reflects widely published ergonomic practice (OSHA computer-workstation concepts); not medical advice — persistent pain deserves a clinician.

When to Use

  • New desk / chair / monitor, or building a WFH corner
  • "What height should my standing desk be?"
  • Neck/shoulder/wrist/eye strain after work sessions
  • Buying decisions: will a 27" monitor be too tall/close for my setup?
  • Periodic re-check after moving furniture

Don't use for: clinical rehabilitation, existing RSI diagnosis treatment (see a professional), or industrial/manual-handling ergonomics (different domain).

The Math (why these numbers)

Proportions of stature H (population-average, seated erect):

QuantityFraction175 cm example
Seat height (popliteal + shoe allowance)0.26 H45.5 cm
Sitting elbow above seat0.155 H27 cm
Desk (keyboard) height0.415 H72.6 cm
Seated eye height (erect)0.674 H118 cm
Standing elbow height0.63 H110 cm
Viewing distance target0.38 H, clamped 50-85 cm66 cm

Consequences worth knowing:

  • A 75 cm fixed desk forces shoulder shrugging on everyone under ~181 cm.
  • Eyes sit ~0.26 H above the desk surface → a 24" monitor's top edge on its lowest stand lands close to eye line; bigger monitors need LOWERING or more distance, not risers.
  • Monitor top edge AT or slightly BELOW eye line; screen center 10-15 cm below eyes; never top edge above eye line.

How It Works — Numbered Steps

  1. Get your numbers:
    python3 scripts/ergo_setup.py calibrate --height 175
    python3 scripts/ergo_setup.py calibrate --height 163 --standing
    
  2. Check a monitor against your setup:
    python3 scripts/ergo_setup.py monitor --height 175 --size 27
    
    → prints top-edge height above desk on a typical stand and the cm of riser/lowering needed to hit eye line.
  3. If you work on a laptop:
    python3 scripts/ergo_setup.py laptop --height 175
    
  4. Diagnose from symptoms:
    python3 scripts/ergo_setup.py symptom --pain neck
    python3 scripts/ergo_setup.py symptom --pain wrist
    
  5. Audit yourself weekly:
    python3 scripts/ergo_setup.py checklist
    

Common Pitfalls

  1. Desk too high is the #1 home-office error. Fix by raising the chair to elbow height and adding a footrest — not by lowering the chair and shrugging.
  2. Monitor directly on laptop-stand height for the built-in keyboard. When you raise the screen to eye level, the built-in keyboard becomes unusable — external keyboard + mouse are mandatory, not optional.
  3. Top edge above eye line. Bigger monitors (27"+) frequently need to be LOWERED or pushed farther away; a 32" at 60 cm distance forces head extension. Distance target scales with screen size.
  4. Keyboard positive tilt. Little feet folded OUT tilt keyboards toward you and extend wrists — keep them folded (neutral or slight negative tilt).
  5. Feet crossed / dangling. Both destroy lumbar position. Footrest or lower chair + footrest.
  6. Static "perfect" posture. The best posture is the NEXT posture: vary position; standing desk users should stand 15-30 min per hour, not all day.
  7. Eyes at arm's length minimum. Closer than 50 cm forces accommodation strain; if you can't read at 60 cm, that's an eye exam, not a closer monitor.
  8. Ignoring glare. Screen facing a window = contrast collapse and adopted neck twist. Screen perpendicular to windows.

Example

$ ergo_setup.py calibrate --height 175
PERSONAL NUMBERS for height 175 cm (sitting):
  Chair seat height:      45.5 cm  (feet flat, knees ~90-100°)
  Desk / keyboard height: 72.6 cm  (elbows 90-110°, shoulders relaxed)
  Monitor TOP edge:       118.0 cm from floor (31.4 cm above desk)
  Screen center:          ~13 cm below eye line
  Viewing distance:       50-85 cm (target ~66 cm)
  Lumbar support:         at belt line (L4-L5), slight recline 100-110°
  Feet:                   flat on floor or footrest, never crossed

$ ergo_setup.py monitor --height 175 --size 27
27" monitor: panel height ~33.5 cm. On a lowest-stand ~5 cm above desk:
  top edge ≈ 39 cm above desk vs eye line 31 cm → 8 cm TOO HIGH.
  Fix: lower the stand; if at minimum, increase distance to ~75-80 cm
  and tilt slightly up toward eyes.

Verification Checklist

  • Elbows at 90-110°, shoulders relaxed (not shrugged) at keyboard
  • Monitor top edge at or slightly below eye line
  • Screen 50+ cm from eyes (arm's length check: press monitor — arm fully extended touches it)
  • Feet flat, knees ~90-100°, no crossed legs
  • Lumbar support contacts belt line
  • Wrists neutral, keyboard feet folded
  • 20-20-20: every 20 min, 20 seconds, 6 m away

Related skills

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván857 installs69 stars

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván561 installs18 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

More from voronindenis5

Browse all skills

Prepare salary negotiations with a structured toolkit: market-rate anchoring math, walk-away floor calculation, total-compensation evaluation (equity, bonuses, benefits), negotiation scripts for offers, raises, and counter-offers, and BATNA analysis. Use when the user has a job offer, is preparing a raise conversation, wants to know if their pay is competitive, or needs scripts and a strategy for negotiating compensation.

by voronindenis51 installs

Use when your calendar is eating your week and you want to know exactly where the time goes, when planning recurring meetings for a team, before proposing a new recurring meeting, when someone says 'we should sync weekly' and you want data, or when auditing which meetings to kill — imports ICS calendar files, measures meeting hours per week/person/meeting-series (including double-bookings and fragmentation), computes focus-time destruction from meeting placement, scores the true cost of each series (hours × attendees × frequency), flags specific meetings to kill/shorten/make-async using explicit rules, and simulates the recovered hours before anyone has to argue about it.

by voronindenis52 installs

Use when you realize your photos/code/documents exist in exactly one place (or your 'backup' is a external drive in the same room as the computer) — audits your actual data-loss risk against the 3-2-1 rule (3 copies, 2 media, 1 offsite) asset by asset, scores blast radius (ransomware encrypts synced copies too), prices honest recovery (professional recovery lab $300-3000 vs $0), generates the minimum-cost redundancy plan for YOUR asset list, and produces a restore-test drill because an untested backup is a hope, not a backup.

by voronindenis52 installs

Audit password vault exports (Bitwarden, 1Password, KeePass, Chrome, Firefox) for reuse, weakness, staleness, breach exposure, and 2FA gaps without ever storing or transmitting a plaintext password. Use when the user asks to audit passwords, check password strength/reuse, review vault health, or verify whether credentials appeared in breaches.

by voronindenis51 installs

Use before any difficult phone call you're anxious about or that has stakes — calling customer service to dispute a fee, negotiating a bill, cold-calling a client, delivering bad news to a vendor, calling a landlord about repairs, insurance disputes, or handling collections calls — builds a branching call script from your situation (goal, leverage, fallback), generates objection→response trees for the specific counter-arguments you'll hear, produces a one-page printable cheat sheet, and includes a practice-drills mode that plays the other side and scores your responses.

by voronindenis51 installs