Menu
how to use Tomlyn for serialization and deserialization of TOML files in C#
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Write scripts and programs against gatOS — the KSA mod that exposes live Kitten Space Agency simulation state as a 9P filesystem at /sim (also over HTTP /v1 and MQTT). Use this when asked to read game/celestial/vehicle telemetry, control vehicles (throttle, ignite, staging, attitude, burns, RCS, lights, docking), use game/debug controls (teleport, impulse kick, refuel, time-warp, switch vessel), or write flight-computer / autopilot programs. Covers the full /sim catalog, the command model, KSA coordinate frames, and worked Bun/TypeScript + Rust examples.
Validate the gatOS mod against a new upstream Kitten Space Agency (KSA) game build — the break-check playbook run when the KSA game / its decompiled sources are bumped and you must decide whether gatOS needs changes. Covers exactly which gatOS surface couples to KSA and where, how to diff the CURRENT (new) vs PREVIOUS (old) decompiled sources, build-as-alarm, semantic-drift review, the reflection + render-internals coupling the compiler can't catch, and which docs to update in lockstep. Use when asked to "check gatOS against the new KSA build", "upgrade KSA", run the version-diff / break-check, or review a game update's impact. REQUIRES two KSA decompiled-source trees to be provided: CURRENT and PREVIOUS.
Author tutorial-style documentation for the gatOS Astro/Starlight docs site (under site/) — the progressive `guides/` series that teaches writing flight-computer / autopilot programs against the gatOS /sim filesystem and its HTTP /v1 mirror. Use this when asked to write, add, or revise a gatOS tutorial or guide, plan the tutorial curriculum, or turn a /sim feature into a lesson. Covers the house style, Starlight/MDX mechanics, the dual-transport (/sim file + HTTP) presentation convention, the reusable code-snippet library, and the beginner→advanced tutorial ladder. Pairs with the `gatos` skill (how the sim works) and docs/TUTORIAL_DATA_REFERENCE.md (the data tutorials are built from).
nanostores state manager
React Compiler automatically memoizes React components at build time, eliminating manual useMemo/useCallback/React.memo. Use when asked about React Compiler setup, memoization automation, "use memo"/"use no memo" directives, incremental adoption, compiler debugging, or build tool integration (Babel, Vite, Next.js, Expo, Metro, Rspack, Rsbuild).
React Rules of React — strict adherence required for React Compiler compatibility. Covers purity, idempotency, immutability, hook call rules, and component rendering rules. Use when writing any React component, custom hook, or reviewing React code.
| name | tomlyn |
| description | how to use Tomlyn for serialization and deserialization of TOML files in C# |
Tomlyn is a high-performance TOML 1.1 library for .NET, shaped like System.Text.Json.
It provides two main layers:
TomlSerializer maps TOML documents to .NET objects (POCOs, records, dictionaries) and back.
Supports reflection and source generation. Does not preserve comments or formatting.TomlLexer, TomlParser, and SyntaxParser provide token streams, incremental events,
and a full-fidelity syntax tree for tooling, analyzers, and formatters that need to preserve every character.| Scenario | Start here |
|---|---|
| New to Tomlyn | Getting started |
Familiar with System.Text.Json | Serialization - the API shape is intentionally similar |
| Need NativeAOT / trimming | Source generation |
| Want a dynamic model (no POCOs) | DOM model - TomlTable, TomlArray |
| Building tooling (formatters, analyzers) | Low-level APIs - SyntaxParser |
| Migrating from Tomlyn v0.x | Migration guide |
[!IMPORTANT] Tomlyn v1 targets TOML 1.1.0 only. It does not support TOML 1.0 or earlier drafts. See the official TOML v1.1.0 specification for the full language reference.
TomlException with precise source locations (Line, Column, Offset, Span).TomlSerializerOptions is a sealed record; cache and reuse instances.TomlSerializerContext) to avoid reflection. Reflection can be disabled via a feature switch.