fs-gg-model-swap

Replace the default model in a FS.GG product with a custom model.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/FS-GG/FS.GG.Game --skill fs-gg-model-swap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fs-gg-model-swap
Source: https://github.com/FS-GG/FS.GG.Game/tree/main/template/product-skills/fs-gg-model-swap
Command: npx skills add https://github.com/FS-GG/FS.GG.Game --skill fs-gg-model-swap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The fs-gg-model-swap skill unit helps you swap out the default model in a FS.GG product with your custom game/UI model without breaking the project structure.

Core Features & Use Cases

  • Model Replacement: Replace the default model with your custom model in a FS.GG product.
  • Minimal Changes: Requires only a few changes to specified files for model replacement.
  • Preserves Build: Ensures the project builds successfully even after model replacement.

Quick Start

Replace the default model with your own by modifying src/<ProductDir>/Model.fs, src/<ProductDir>/View.fs, and tests/Product.Tests/BehaviorTests.fs as per the guidelines in docs/scaffold-map.md.

Frequently Asked Questions about fs-gg-model-swap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I replace the default model in a FS.GG product with my own?

Replace the default model by updating `src/<ProductDir>/Model.fs` and `src/<ProductDir>/View.fs` following guidelines in `docs/scaffold-map.md`. This coordinates minimal file changes to integrate your custom model while preserving project build integrity.

What is model swapping in custom game and UI development?

Model swapping replaces a platform's default starter model with a custom game or UI model. It coordinates minimal file changes to maintain project structure integrity and ensure successful builds within the FS.GG platform.

Can I swap models in FS.GG without breaking the project build?

Yes, you can swap models without breaking the build. The process requires only a few specified changes to files like `Model.fs` and `View.fs` to maintain project structure and ensure the FS.GG product builds successfully after replacement.

Which files need modification for product customization through model replacement?

Model replacement requires modifying `src/<ProductDir>/Model.fs`, `src/<ProductDir>/View.fs`, and `tests/Product.Tests/BehaviorTests.fs`. Consult `docs/scaffold-map.md` for specific file modification guidelines.

Why does my FS.GG project fail behavior tests after a model swap?

A FS.GG project fails behavior tests after a model swap if `tests/Product.Tests/BehaviorTests.fs` is not updated to match the new custom model. You must update this test file alongside the model and view files to maintain build integrity.