Customizable files for deterministic hierarchy and governance of agents via various: SKILL.md, AGENTS.md, template files, and scripts
Install
npx skillscat add velcrafting/codex-skills/skills-system-state-machine-mapper Install via the SkillsCat registry.
SKILL.md
You are executing the SKILL: state-machine-mapper.
Target:
Task:
Convert the component’s behavior into an explicit state machine.
Requirements:
- Enumerate all states, including transient and error states
- Enumerate all transitions with triggers and guards
- Do not collapse states for brevity
- Include invalid or “should not happen” paths if they are possible
- Assume asynchronous and external failures are possible unless proven otherwise
Outputs (write exactly):
- Create or overwrite:
/.state-machine.md
That file must include:
- State definitions with entry/exit conditions
- A complete transition table
- A Mermaid state diagram
- A Findings section listing:
- Missing transitions
- Ambiguous logic
- Hidden assumptions
- Coupling to external systems
Rules:
- Every conditional branch in code must appear in the transition table
- If behavior is unclear, mark it explicitly as ambiguous
- Do not modify source code unless explicitly instructed
Begin by reading the target component in full.