fosmvvm-fields-generator
by foscomputerservices
CommunicationBrief
Generate FOSMVVM Fields protocols with validation rules, FormField definitions, and localized messages.
Description
What This Skill Does
Generates the three files that make up a FOSMVVM Form Specification: a Swift protocol with FormField definitions and validation methods, a messages struct with localized string properties, and a YAML localization file. The generated protocol becomes the single source of truth for a form's fields, constraints, and messages, adopted by request bodies, ViewModels, and persistence models alike.
Defining the protocol once and having request bodies, ViewModels, and database models all adopt it eliminates the drift that occurs when validation logic is duplicated across layers.
When to Use It
- Defining validation rules for a new user registration form
- Adding field contracts to a Fluent DataModel before wiring up the database
- Generating localization YAML for a settings edit screen
- Creating a typed login credentials protocol shared between client and server
- Scaffolding a search or filter form with keyboard semantics and autofill hints
Example Workflow
User asks: generate fields for an idea creation form with a title and a content body
- 1
Identifies form purpose as create, entity as Idea, protocol name as CreateIdeaFields
- 2
Designs two fields: titleField (text, required, length-constrained) and contentField (textArea, required, length-constrained)
- 3
Generates CreateIdeaFields.swift with protocol definition, FormField statics, and validate methods
- 4
Generates CreateIdeaFieldsMessages.swift with @FieldValidationModel struct and @LocalizedString properties
- 5
Generates CreateIdeaFieldsMessages.yml with English titles, placeholders, and validation error strings
Three files placed under Sources/{ViewModelsTarget}/FieldModels/ and Sources/{ResourcesPath}/FieldModels/ covering the full form contract
Installation
clawhub install foscomputerservices/fosmvvm-fields-generatorRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.