best-human-ui

Applies Sociomedia SHIG principles to UI design, implementation, and review tasks.

1|Updated Jul 16, 2026
One-click install
npx skills add https://github.com/sota411/codex-config --skill best-human-ui-sota411
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: best-human-ui
Source: https://github.com/sota411/codex-config/tree/main/user-skills/best-human-ui
Command: npx skills add https://github.com/sota411/codex-config --skill best-human-ui-sota411

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? UI design and review decisions often rely on subjective taste rather than established human interface guidelines. This Skill grounds UI/UX work in Sociomedia's Human Interface Guidelines (SHIG), providing 100 numbered principles with official tags and sources so every design decision or review finding can cite a concrete, verifiable criterion. ## Core Features & Use Cases - Principle-Based Design: Select 1-4 relevant official tags from a task index, then look up only the applicable principles across model, interaction, and presentation categories before making design decisions. - Structured UI Review: Produce findings with severity, location, observed evidence, SHIG principle number, user impact, and concrete fixes, using [must]/[should]/[consider] labels when no project convention exists. - Use Case: When reviewing a checkout form, the Skill selects tags like shig-form and shig-error, reads only the relevant principles (e.g., good defaults, constructive error messages), and reports issues such as a missing default value citing principle 42 with its source URL. ## Quick Start Use the best-human-ui skill to review this screen's form layout and navigation against the relevant SHIG principles.

Frequently Asked Questions about best-human-ui

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

FAQPage Schema
How do I review a UI against human interface guidelines?▼

Select 1-4 relevant official tags from the task index based on the request, then read only the matching principles in the model, interaction, and presentation references. Report each finding with severity, location, observed evidence, the SHIG principle number, user impact, and a concrete fix.

What are the SHIG principles used for UI design?▼

SHIG is Sociomedia's set of 100 human interface guidelines covering model, interaction, and presentation concerns. This Skill organizes them under 23 official tags such as shig-form, shig-navigation, and shig-accessibility so only relevant principles are applied to each task.

Does this Skill replace accessibility standards like WCAG?▼

No. Explicit requirements, platform conventions, and accessibility standards such as WCAG take priority over SHIG. The Skill never claims legal or WCAG compliance based on SHIG alone and states which rule was adopted when conflicts occur.

When should I not use SHIG principles for a design task?▼

Do not use it to enumerate all 100 principles as a checklist unless explicitly requested, and do not override existing design system consistency using SHIG as justification. Visual personality work belongs to frontend-design and shadcn-specific implementation to the shadcn skill.

How are review findings prioritized without project conventions?▼

When the caller or repository has no review format convention, findings use [must], [should], and [consider] labels. Task failure, data loss, unrecoverable operations, and violations of explicit requirements are always classified as [must].