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).
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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/hud-first/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How hud-first Compares
| Feature / Agent | hud-first | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/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
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
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
Focuses on rules and best practices for mobile-first design and responsive typography using tailwind.
koan-entity-first
Entity<T> patterns, GUID v7 auto-generation, static methods vs manual repositories
alignfirst
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
**API FIRST DESIGN**: 'API 만들어', 'API 설계', '엔드포인트', 'REST', 'Swagger', 'OpenAPI', 'DTO', 'CRUD' 요청 시 자동 발동. *.controller.ts/*.dto.ts/routes/** 파일 작업 시 자동 적용. Contract-First, 표준 응답 포맷, 타입 자동 생성.
bgo
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.
testing-builder
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
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
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
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
Use when implementing any feature or bugfix, before writing implementation code