返回资讯中心
外部精选
软件工程
#开发者实时流

I created a tools for devs and users with AuDHD issues to have friendly UIs

Practical guidance for developers and AI agents building interfaces that are easier to understand, use, pause, resume and correct.

Hacker News 最新fashiontechguru2026/10/19 · 27 天前30 分钟阅读

以下正文同步自 Hacker News 最新,版权归原站所有,已转换为易读排版。

Practical guidance for developers and AI agents building interfaces that are easier to understand, use, pause, resume and correct.

Version: v1.01 · Updated October 19, 2026

What is this? · Use it · Install it · What else?

Guide: Rules for making context, relationships, actions and recovery understandable. Use it to design or review an interface, with or without AI.

Skill: A workflow for AI development agents: understand your codebase, apply the Guide and verify improvements.

Examples: An annotated screenshot gallery, worked patterns, runnable React and Svelte interfaces, and 22 skins with chart palettes. Explore the choices, see the rules in action and adapt useful patterns to your own stack.

How do I use it?

Select or name the audhd-ui-guide skill, then choose a prompt below. Paste prompts into your agent’s chat:

Start with one task; you do not need to redesign everything. For a manual review, follow Try one small review. For agents without skill discovery, use the attachment-based instructions.

Choose one platform and one scope: personal installation makes the skill available across your projects; project installation makes it available inside one application project. ~ means your home directory; paths without ~ start at the application project.

Download with Git: This creates an audhd-ui-guide folder inside your current directory. You can run it from your chosen skills directory to install there directly:

git clone https://github.com/Greyland-Fireworks/audhd-ui-guide.git

Codex: Put the folder at ~/.agents/skills/audhd-ui-guide/ for personal use across projects, or .agents/skills/audhd-ui-guide/ inside the project being worked on. See Codex skill locations.

Claude Code: Use ~/.claude/skills/audhd-ui-guide/ for personal use or .claude/skills/audhd-ui-guide/ inside a project. See Claude Code skill locations.

Cursor: Use ~/.cursor/skills/audhd-ui-guide/ for personal use or .cursor/skills/audhd-ui-guide/ inside a project. Cursor also supports the .agents/skills/ locations used by Codex; choose one location rather than installing duplicate copies. See Cursor skill locations.

Keep the supporting files together: Keep SKILL.md, GUIDE.md and the other public files in their original relative locations. Exclude ignored research, personal profiles, dependencies and build/test output when copying a working checkout.

Confirm it is available: Open the application project in your agent and select or name audhd-ui-guide. Check the skill selector; refresh or restart the agent if needed. Local installation does not automatically install the skill in a remote or cloud environment—follow that platform's setup instructions there.

Reading the Guide and using the Skill require no npm installation. Run the examples only if you want to explore the demonstrations.

To clone directly into your current empty directory, name that directory audhd-ui-guide and run:

git clone https://github.com/Greyland-Fireworks/audhd-ui-guide.git .

On Windows, use the corresponding folders under your user home or project. For an agent running in WSL, use its Linux environment's folders.

The platform links above document the installation locations. This project has not tested end-to-end skill installation in each platform.

Personal choice matters: Accessible behavior is mandatory; light/dark skins, typography and enjoyable visual variety are selectable. No single appearance suits everyone. See personalization.

You can set priorities: Choose primary targets and rule emphasis to focus the work without weakening accessibility, authorization or correct behavior.

Audits start with findings: An audit reviews the interface. Ask explicitly when you want implementation; ordinary use does not authorize publishing, changing permissions or storing personal preferences.

The examples have clear limits: Demo reviews stay in memory and reset on reload. Export downloads preferences only. Keep personal preference files private; see the preference contract.

Evidence has boundaries: Automated reference checks have passed; actual browser zoom, screen-reader operation and participant evaluation remain pending. This practitioner guidance is not a clinical intervention or accessibility certification. See the acceptance record.

Reuse and feedback are welcome: Code and CSS use MIT; documentation uses CC BY 4.0, with separate logo terms. See licensing, contribution guidance and the community.

More detail

Choose the next task that matters to you:

I want to… Open this

Understand the rules and visual treatment Combined guide

Understand UI versus UX and where each is covered Project definitions

Organize a dashboard with clear priorities and navigation Dashboard organization

Group related tools and settings into tabs or expandable sections Tabs, sub-tabs and accordion sections

Tailor colors, text, density, motion or interruption support Personalization overview and JSON reference

Check an existing interface Review template

See context, help and recovery in practice Worked examples

Use the guide with an LLM Usage instructions and agent skill

Evaluate an LLM's use of the guide Skill evaluation pack

Suggest a change or share evidence Contribution guidance

Ask a question or discuss an example Discord community

Run the reference examples

Recording-review setup · Palette preview and tokens · Framework adapters · Evidence and limits

These are local demonstrations. Reviews reset on reload; export downloads preferences only.

With Node 22.12+ installed, open a terminal in the repository root—the folder containing package.json—and install dependencies once:

npm ci

React: Start the server, then open the React example:

npm run dev:react

Svelte: In a separate terminal at the same repository root, start the server and open the Svelte example:

npm run dev:svelte

You can run either example independently. If a port is already in use, follow the alternate-port instructions. To explore palettes without starting either app, open the palette preview in your browser.

Choose a real task. For example: edit a setting, save it, leave and return.

Follow the task from beginning to end. Include a mistake or failed save where you can test safely.

Write down what happened. Use the review template, select the relevant rule IDs and identify one focused improvement.

Keep these questions nearby:

Set up the skill

Follow How do I install it? for download commands, platform locations and discovery checks.

Open the project you want reviewed and name the screen or workflow. Provide relevant source files, screenshots or an accessible running interface as available. Explain the task users need to complete, any known difficulty and whether you want review, design or implementation.

Skill installation and explicit invocation syntax vary by tool. You can name the skill in your request:

Use the audhd-ui-guide skill to review the report settings form. Focus on changing the destination, saving, recovering a failed save and returning later. Review only.

Once the skill is available to the agent, type audhd audit as a request. The phrase is case-insensitive and is an instruction recognized by this skill, not a shell command or a separately installed slash command. If your agent does not discover it automatically, explicitly select or name audhd-ui-guide with the request.

The audit is review-only by default. Expect prioritized findings that distinguish UI, UX or both, identify relevant rule IDs and evidence, and recommend focused changes and verification steps. Checks that cannot be performed remain pending. A screenshot can support visible-layout findings but cannot prove save behavior, keyboard access or user understanding. No findings is a valid outcome when the available evidence justifies no change; remaining evidence gaps must still be reported.

The trigger does not request a whole-project redesign, theme migration or model evaluation. To authorize implementation, say so explicitly and bound the change:

Use the audhd-ui-guide skill. Audit the settings form, then fix misleading save feedback and inaccessible help. Preserve existing permissions and saved work; report the changes, actual checks and remaining gaps.

Use the opening prompts to request a dashboard, front end or focused improvement. Include the relevant files, intended task and any project constraints. An audit is optional.

Ask the agent to distinguish verified behavior from unknowns, preserve existing permissions and saved work, and report checks actually performed. A focused change does not authorize a whole-application redesign.

Attach SKILL.md, GUIDE.md and REVIEW_TEMPLATE.md to the conversation and use this prompt:

Apply the attached AuDHD-friendly interface guide to [interface and task]. Follow the skill instructions, including selectable appearance, task continuity and system accessibility constraints. Stay within this task and preserve existing behavior and saved work. Distinguish UI and UX concerns; report relevant rule IDs, evidence, checks performed and remaining gaps. Review only unless I ask you to implement changes.

Attach EXAMPLES.md when examples would help. For personalization work, also attach PREFERENCES.md and preferences.example.json; the JSON is a fictional reference, not a personal profile.

For individual design or personalization, the skill offers a brief, optional intake about display and interaction needs. Answer only what matters, try a preview or skip the questions. A diagnosis is never required. For products serving many people, one person's preferences do not represent every user.

Options include color plus labels/shapes/patterns, text size and spacing, density, motion, sound, optional notifications, help detail and interruption recovery. The preference guidance explains the questions, storage rules and supported profile format.

Use larger text and no optional sounds for this task. Skip the other preference questions and do not save a profile.

Save the text scale and sound preference we just agreed on for this project in audhd-preferences.local.json. Keep my other saved choices unchanged.

Saving a preference does not implement or verify it. The example JSON illustrates the format; the JSON field reference explains every option. Unsupported preferences must be reported. System accessibility overrides and privacy requirements remain in effect.

Area for improvement: Intake, profile handling and preference effects need real-user and integration testing. See the documented follow-up.

AuDHD commonly refers to the co-occurrence of autism and ADHD. Some people want a focused view; others need a dense overview. Offer useful choices and test them with the people doing the work. You do not need to disclose a diagnosis to contribute.

This is a practitioner guide, not a clinical intervention or certification. Its specific patterns have not been established here through research with a representative group of AuDHD users. No skin, font or information density is claimed to suit every AuDHD person.

Version v1.01 is being prepared for publication. The Guide remains practitioner guidance with the evidence limits described above. All 34 prepared model-evaluation scenarios remain unrun and require a separate explicit request. Those evaluations are not required for ordinary use or feedback, and successful text reviews would not prove real-interface usability.

Despite the serious concerns about the social and ecological impacts of AI/ML, working with Large Language Models to develop software has been life-changing for me.

Throughout my life, I tried several times to learn programming. But the way my AuDHD brain works made it difficult to retain and recall the information I needed in the moment to write code manually.

The only languages I was ever able to work with were HTML and Terrapin Logo. I knew a great deal about computers and technology, even built huge interactive art projects for hacker conferences, but I always felt shut out of the driver’

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →