hud-first

This skill should be used when the user asks to "build an AI assistant", "create a chatbot", "make an agent that does X for me", "design a copilot feature", "automate this workflow with AI", or requests delegation-style AI features. Offers a reframe from copilot patterns (conversation, delegation) to HUD patterns (ambient awareness, perception augmentation).

16 stars

Best use case

hud-first is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

This skill should be used when the user asks to "build an AI assistant", "create a chatbot", "make an agent that does X for me", "design a copilot feature", "automate this workflow with AI", or requests delegation-style AI features. Offers a reframe from copilot patterns (conversation, delegation) to HUD patterns (ambient awareness, perception augmentation).

Teams using hud-first should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/hud-first/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/ai-agents/hud-first/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/hud-first/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How hud-first Compares

Feature / Agenthud-firstStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

This skill should be used when the user asks to "build an AI assistant", "create a chatbot", "make an agent that does X for me", "design a copilot feature", "automate this workflow with AI", or requests delegation-style AI features. Offers a reframe from copilot patterns (conversation, delegation) to HUD patterns (ambient awareness, perception augmentation).

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

<objective>
Shift from the copilot anti-pattern (delegation, conversation, context-switching) to the HUD pattern (perception, ambient awareness, flow preservation). Based on Mark Weiser's 1992 critique of AI agents, Douglas Engelbart's Intelligence Augmentation, Steve Jobs' "bicycle for the mind," and Amber Case's Calm Technology principles.
</objective>

<quick_start>
When facing a problem, ask:

**Instead of:** "What agent/assistant can do this for me?"
**Ask:** "What new sense would let me perceive this problem differently?"

The goal is not automation. The goal is augmentation.
</quick_start>

<essential_distinction>
| Copilot (Anti-pattern) | HUD (Target) |
|------------------------|--------------|
| You talk to it | You see through it |
| Demands attention | Operates in periphery |
| Delegates your judgment | Extends your perception |
| Context-switching tax | Flow-state preserving |
| "Do this for me" | "Now I notice more" |
</essential_distinction>

<reframing_process>
To reframe any problem using HUD-first thinking:

1. **Identify the copilot instinct**
   - What task are you tempted to delegate?
   - What conversation would you have with an assistant?

2. **Extract the information need**
   - What does the assistant need to *know* to help?
   - What would you need to *perceive* to not need the assistant?

3. **Design the sense extension**
   - What visual/auditory/haptic signal would make this obvious?
   - How could this information be ambient rather than on-demand?

4. **Validate with the spellcheck test**
   - Spellcheck doesn't ask "would you like help spelling?"
   - It just shows red squiggles. You notice. You decide.
   - Does your solution pass this test?
</reframing_process>

<examples>
<example name="code_review">
<copilot_approach>
"Review this code for bugs and suggest improvements"
→ Conversation, delegation, waiting, context-switch to read response
</copilot_approach>

<hud_approach>
- Inline complexity warnings (like spell-check for cognitive load)
- Test coverage heatmap in the gutter
- Type inference annotations that appear on hover
- Mutation testing results as background highlights
→ You *see* code quality. No conversation needed.
</hud_approach>
</example>

<example name="email_triage">
<copilot_approach>
"Summarize my inbox and tell me what's urgent"
→ You're now reading the AI's interpretation, not the emails
</copilot_approach>

<hud_approach>
- Urgency highlighting (color gradient based on signals)
- Relationship context badges (how often you interact)
- Sentiment indicators (tone of message)
- Thread age/velocity visualization
→ You *perceive* inbox state at a glance. You decide what matters.
</hud_approach>
</example>

<example name="debugging">
<copilot_approach>
"Find the bug in this function"
→ Delegation of understanding. You learn nothing.
</copilot_approach>

<hud_approach>
- Live variable values overlaid during execution
- Control flow visualization (which branches taken)
- State diff between invocations
- Anomaly highlighting (this value is unusual)
→ You *see* program behavior. The bug becomes obvious.
</hud_approach>
</example>

<example name="writing">
<copilot_approach>
"Rewrite this paragraph to be clearer"
→ You lose your voice. You're editing AI output, not your thoughts.
</copilot_approach>

<hud_approach>
- Readability score in margin (updates as you type)
- Sentence complexity highlighting
- Passive voice indicators
- Repetition detection
→ You *sense* where prose is weak. You fix it your way.
</hud_approach>
</example>
</examples>

<design_principles>
From Calm Technology (Weiser, Case):

1. **Require minimal attention** — Lives in peripheral awareness
2. **Extend senses, don't replace judgment** — New information channels, same human decision-maker
3. **Communicate without speaking** — Color, position, sound, vibration—not dialog boxes
4. **Stay invisible until needed** — Information surfaces when relevant, recedes when not
5. **Amplify Human+Machine** — Optimize the interface between them, not either alone
</design_principles>

<when_copilot_is_fine>
Delegation works for:
- Routine, predictable tasks (autopilot for straight-level flight)
- Tasks you genuinely don't want to understand
- One-time operations with clear success criteria

But for expert work, creative work, complex judgment—you want instruments, not a chatbot to argue with.
</when_copilot_is_fine>

<challenge>
For your current problem:

1. What would a "red squiggly" look like for this domain?
2. What sense would you need to perceive the solution space directly?
3. How could the information be *ambient and continuous* rather than *requested and discrete*?

The best AI interface is often invisible. You just become aware of more.
</challenge>

<success_criteria>
HUD-first reframing is successful when:

- The proposed solution doesn't require conversation or explicit requests
- Information flows continuously rather than on-demand
- The human remains in control of judgment and decision
- Flow state is preserved (no context-switching to interact with AI)
- The user would describe it as "now I just *notice* things I didn't before"
</success_criteria>

Related Skills

staging-ui-first

16
from diegosouzapw/awesome-omni-skill

UI-first implementation and staging workflow for Zeus. Use when building routes, components, or forms before backend integration, or when creating UI scaffolds with mock data and later wiring to real APIs.

research-first-principle-deconstructor

16
from diegosouzapw/awesome-omni-skill

Rigorous Socratic interrogator and research architect that helps researchers overcome incremental thinking by applying First Principles analysis. Use when a researcher presents a research problem, proposed methodology, draft idea, or scientific hypothesis and wants to expose hidden assumptions, identify fundamental physical/mathematical constraints, generate unconventional radical alternatives, or deepen mechanistic understanding through probing questions. Triggers on phrases like "I want to improve X by doing Y", academic research brainstorming, scientific hypothesis generation, or any request to stress-test, challenge, or deconstruct a research idea. Do NOT trigger for pure literature reviews, writing assistance, or non-research tasks.

mobile-first-design-rules

16
from diegosouzapw/awesome-omni-skill

Focuses on rules and best practices for mobile-first design and responsive typography using tailwind.

koan-entity-first

16
from diegosouzapw/awesome-omni-skill

Entity<T> patterns, GUID v7 auto-generation, static methods vs manual repositories

alignfirst

16
from diegosouzapw/awesome-omni-skill

Collaborative problem-solving protocols: write technical specifications (spec, or alspec), create implementation plans (plan, or alplan), or use Align-and-Do Protocol (AAD). Also generates PR/MR descriptions (aldescription).

api-first-design

16
from diegosouzapw/awesome-omni-skill

**API FIRST DESIGN**: 'API 만들어', 'API 설계', '엔드포인트', 'REST', 'Swagger', 'OpenAPI', 'DTO', 'CRUD' 요청 시 자동 발동. *.controller.ts/*.dto.ts/routes/** 파일 작업 시 자동 적용. Contract-First, 표준 응답 포맷, 타입 자동 생성.

bgo

10
from diegosouzapw/awesome-omni-skill

Automates the complete Blender build-go workflow, from building and packaging your extension/add-on to removing old versions, installing, enabling, and launching Blender for quick testing and iteration.

Coding & Development

testing-builder

16
from diegosouzapw/awesome-omni-skill

Automatically generates comprehensive test suites (unit, integration, E2E) based on code and past testing patterns. Use when user says "write tests", "test this", "add coverage", or after fixing bugs to create regression tests. Eliminates testing friction for ADHD users.

Testing Anti-Patterns

16
from diegosouzapw/awesome-omni-skill

This skill should be used when encountering "flaky tests", "test maintenance issues", "slow test suites", "brittle tests", "test code smells", "test debugging problems", or when tests are hard to understand, maintain, or debug.

testcontainers-integration-tests

16
from diegosouzapw/awesome-omni-skill

Use when integration tests require real infrastructure (database, message queue, cache) or when mocking infrastructure is insufficient. Defines container lifecycle, test isolation, and performance optimization for Testcontainers-based testing.

test-generation

16
from diegosouzapw/awesome-omni-skill

Master skill for intelligent test case generation. Identifies technology stack and delegates to specialized testing sub-skills for creating high-quality integration and API tests.

test-driven-development

16
from diegosouzapw/awesome-omni-skill

Use when implementing any feature or bugfix, before writing implementation code