hwc-stimulus-fundamentals
Cover Stimulus controller fundamentals: lifecycle hooks, values and valueChanged callbacks, targets and target callbacks, outlets, action parameters, keyboard events, and controller architecture patterns. Prefer this skill when the request is primarily about Stimulus APIs and controller design independent of a specific Hotwire domain. Use hwc-forms-validation for form-specific workflows, hwc-navigation-content for Turbo navigation concerns, hwc-realtime-streaming for Turbo Streams/WebSocket patterns, hwc-media-content for media integrations, and hwc-ux-feedback for loading/progress/transition UX patterns.
How do I install this agent skill?
npx skills add https://github.com/thehotwireclub/hotwire_club-skills --skill hwc-stimulus-fundamentalsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
No security issues detected. The skill provides architectural guidelines and code examples for Stimulus.js development using standard practices and well-known external resources.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
10/10 files flagged
What does this agent skill do?
Stimulus Fundamentals
Implement robust Stimulus controllers with clear lifecycle and state boundaries.
Core Workflow
- Define controller contract first: targets, values, outlets, actions, and expected lifecycle.
- Keep state transitions in value callbacks when reactive updates are required.
- Guard callbacks that can run before
connect()completes. - Use
connect()/disconnect()for setup and teardown symmetry. - Isolate DOM event handling from business rules; keep controllers composable.
Guardrails
- Prefer declarative action parameters over manual dataset parsing.
- Use outlets for controller-to-controller communication instead of private internals.
- Keep target callbacks idempotent; account for repeated connect/disconnect cycles.
- Use MutationObserver only when DOM-driven reactivity is required.
- Feature-detect browser APIs before exposing UI affordances.
Load References Selectively
Open only the file needed for the current request.
- Value changed callbacks:
references/2023-08-29-stimulus-value-changed-callbacks.md - Keyboard action filters and hotkeys:
references/2023-10-24-stimulus-keyboardevent-101.md - MutationObserver-based sorting:
references/2023-12-05-stimulus-auto-sorting.md - Outlets API communication:
references/2023-12-19-stimulus-outlets-api.md - Target callback orchestration:
references/2024-05-07-stimulus-target-callbacks.md - Web Share API integration:
references/2025-11-25-stimulus-web-share-api.md - Core Web Vitals and lazy-loading fundamentals:
references/2024-06-18-fundamentals-core-web-vitals.md - Promise-returning outlet methods (await-able controller APIs):
references/2026-07-22-stimulus-promise-returning-outlet-methods.md
Use references/INDEX.md for the full catalog.
Escalate to Neighbor Skills
- Form-centric behavior: use
hwc-forms-validation - Navigation/history/cache with Turbo: use
hwc-navigation-content - Turbo Stream/WebSocket orchestration: use
hwc-realtime-streaming - Media integrations and playback concerns: use
hwc-media-content - UX feedback/transitions/progress concerns: use
hwc-ux-feedback
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/thehotwireclub/hotwire_club-skills/hwc-stimulus-fundamentals">View hwc-stimulus-fundamentals on skillZs</a>