---
title: "State Machine - Air Market"
description: "When a component has loading, error, empty, selected and disabled all tangled together, it is easy to miss a case. This models the states, the events, and the moves between them so the set is complet…"
canonical: "https://airmarket.ai/app/state-machine"
---

[Air Market](/) / [Design](/category/design) / State Machine

Skill by [MC Dean](/@owl-listener)

# State Machine

Pin down every state a component can be in

## What this does

When a component has loading, error, empty, selected and disabled all tangled together, it is easy to miss a case. This models the states, the events, and the moves between them so the set is complete. Reach for it when the states interact and you need to cover all of them. For how a single interaction should feel, see micro-interaction-spec.

### Top 3 things it does for you

- List a component's states and events
- Map which state leads to which
- Check no combination has been left out

## Information

**State Machine at a glance**

|  |  |
| --- | --- |
| Kind | Skill |
| Publisher | [MC Dean](/@owl-listener) |
| Category | [Design](/category/design) |
| Works with | Agent Skills - an open standard supported by 40+ agents |
| Size | 2 KB |
| Licence | MIT |
| Repository | [Owl-Listener/designer-skills](https://github.com/Owl-Listener/designer-skills/tree/20e34c4a587e5eb09fcdf8351fa97b3ad761b31e/interaction-design/skills/state-machine) |
| GitHub stars | 2,144 (as of Nov 2026) |

## Security report

**Verified.** AIR scanned this exact version of State Machine and flagged nothing. AIR's verdict: **safe**.

**What State Machine's check was run against**

|  |  |
| --- | --- |
| Commit | 20e34c4a587e5eb09fcdf8351fa97b3ad761b31e |
| Content hash | 9ccb8829ef65615c04231d666d54f498677e32b6d8c29162f5c7a0f531e4308e |
| Files read | [Browse the files at this exact commit](https://github.com/Owl-Listener/designer-skills/blob/20e34c4a587e5eb09fcdf8351fa97b3ad761b31e/interaction-design/skills/state-machine/SKILL.md) |

A scan is named by the exact content it read, not by a version number. A different version is a different artifact, and nothing here applies to a version AIR has not scanned.

[Read the full security report for State Machine](/security/state-machine)

## About State Machine

This skill models component behaviour as explicit states, events, and transitions, so what the component does is written out rather than discovered in use.

Use it when a component has many interacting states and the set has to be exhaustive. For the feel and feedback of a single interaction, the description points to `micro-interaction-spec`.

## What's inside

- SKILL.md - instructions

## Questions

### Is State Machine safe to install?

AIR scanned this exact version of State Machine and flagged nothing. AIR's verdict: safe. The verdict is named by the content that was read, at commit 20e34c4a587e, so it cannot drift onto a version nobody scanned. The full report is at https://airmarket.ai/security/state-machine.

### How do I install State Machine?

Open https://airmarket.ai/app/state-machine on Air Market and use the install action: Air Market hands Claude a prompt naming this exact skill, and Claude sets it up. Source, pinned to the exact commit this listing describes: https://github.com/Owl-Listener/designer-skills/tree/20e34c4a587e5eb09fcdf8351fa97b3ad761b31e/interaction-design/skills/state-machine. Install from that link, not the branch.

## Related on Air Market

- [More Design listings](/category/design)
- [Everything by MC Dean](/@owl-listener)

---

Canonical URL: <https://airmarket.ai/app/state-machine>