fsm-design

Specialized skill for finite state machine design and optimization in FPGAs

509 stars

Best use case

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

Specialized skill for finite state machine design and optimization in FPGAs

Teams using fsm-design 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/fsm-design/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/specializations/fpga-programming/skills/fsm-design/SKILL.md"

Manual Installation

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

How fsm-design Compares

Feature / Agentfsm-designStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Specialized skill for finite state machine design and optimization in FPGAs

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

# FSM Design Skill

## Overview

Specialized skill for finite state machine (FSM) design and optimization, ensuring robust and efficient control logic implementation in FPGA designs.

## Capabilities

- Design Moore and Mealy state machines
- Apply state encoding (one-hot, binary, Gray)
- Implement illegal state recovery
- Generate state diagrams and transition tables
- Optimize FSM for area or speed
- Apply safe FSM coding patterns
- Debug FSM behavior with assertions
- Handle FSM with multiple clock domains

## Target Processes

- fsm-design.js
- rtl-module-architecture.js
- vhdl-module-development.js
- verilog-systemverilog-design.js

## Usage Guidelines

### FSM Types
- **Moore Machine**: Outputs depend only on current state
- **Mealy Machine**: Outputs depend on state and inputs
- **Registered Outputs**: Mealy with registered outputs for timing

### State Encoding
- **One-Hot**: Fast, low combinational logic, more flip-flops
- **Binary**: Compact, minimal flip-flops, more logic
- **Gray**: Useful for CDC, single-bit transitions
- **Custom**: For specific optimization requirements

### Safe FSM Patterns
- Explicit default state in case statements
- Illegal state detection and recovery
- Synchronous reset to known state
- Avoid latches (cover all cases)
- Use enumerated types for readability

### VHDL Style
```vhdl
type state_type is (IDLE, RUN, DONE);
signal state, next_state : state_type;
```

### Verilog Style
```verilog
localparam [1:0] IDLE = 2'b00, RUN = 2'b01, DONE = 2'b10;
reg [1:0] state, next_state;
```

### Optimization Strategies
- Minimize state bits for area
- One-hot for speed in FPGAs
- Pipeline deep combinational logic
- Consider state splitting for timing

## Dependencies

- FSM analysis tools
- Synthesis attribute knowledge
- HDL coding standards

Related Skills

rest-api-design

509
from a5c-ai/babysitter

RESTful API design principles, versioning, pagination, HATEOAS, and documentation.

design-tokens

509
from a5c-ai/babysitter

Design token management, generation, and multi-platform support.

design-token-transformer

509
from a5c-ai/babysitter

Transform design tokens across multiple formats and platforms. Parse W3C design token format, transform to CSS/SCSS/JS/iOS/Android, handle token aliases and references, and generate documentation.

design-system-validator

509
from a5c-ai/babysitter

Validate design system compliance in code and detect token usage violations

scope-permission-designer

509
from a5c-ai/babysitter

Design and implement scoped permission models

rate-limiter-designer

509
from a5c-ai/babysitter

Design and implement rate limiting strategies

protobuf-grpc-designer

509
from a5c-ai/babysitter

Protocol Buffers and gRPC service definition with backward compatibility checks

middleware-chain-designer

509
from a5c-ai/babysitter

Design middleware and interceptor chains for SDK extensibility

graphql-schema-designer

509
from a5c-ai/babysitter

GraphQL schema design and optimization with federation support

SSA/IR Design

509
from a5c-ai/babysitter

Expert skill for designing intermediate representations and implementing SSA construction

Grammar Design

509
from a5c-ai/babysitter

Expert skill for formal grammar design including disambiguation, precedence, and validation

FFI Design

509
from a5c-ai/babysitter

Expert skill for designing and implementing foreign function interfaces to native code