# files

> Data and settings files parse, match their schema, and use one layout.

Data and settings files parse, match their schema, and use one layout.

## Checks

| Check                                                         | Stage    | Level         | What it does                                                                                                           |
| ------------------------------------------------------------- | -------- | ------------- | ---------------------------------------------------------------------------------------------------------------------- |
| [`files/taplo-format`](/reference/checks/files/taplo-format/) | `commit` | `recommended` | Checks that every TOML file parses and matches the taplo output under the shared settings.                             |
| [`files/yamllint`](/reference/checks/files/yamllint/)         | `commit` | `recommended` | Parses every YAML file and checks its indentation, keys, and values with yamllint.                                     |
| [`files/v8r`](/reference/checks/files/v8r/)                   | `push`   | `recommended` | Validates each file that matches a SchemaStore schema, such as package.json, tsconfig.json, mise files, and workflows. |
| [`files/xmllint`](/reference/checks/files/xmllint/)           | `commit` | `recommended` | Parses every XML file with xmllint.                                                                                    |

## Settings

| Setting                                                             | What it sets                                                                                                                                                                                  |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`tools.yamllint.rules`](/reference/gspot-toml/#toolsyamllintrules) | Option tables for active YAML rules; the level decides which rules run, and \[format] sets the width. Ignore a finding with gspot ignore files/yamllint `--rule` `<rule>` `--reason` `<why>`. |
| [`tools.v8r.schema`](/reference/gspot-toml/#toolsv8rschema)         | File patterns mapped to schema URLs, for files that the SchemaStore catalog does not know.                                                                                                    |

## Selected when

Always selected.

## Rules for coding agents

| Rule file                                           | Installed when |
| --------------------------------------------------- | -------------- |
| `.gspot/configurations/general/files/rules/YAML.md` | Always         |

## Tools and versions

| Tool     | Version  |
| -------- | -------- |
| taplo    | `0.10.0` |
| yamllint | `1.38.0` |
| v8r      | `6.1.0`  |
| ajv      | `8.20.0` |
| xmllint  | Any      |

## Files gspot writes

gspot writes `.gspot/configurations/general/files/taplo.toml`, `.gspot/configurations/general/files/yamllint.yml`, and `.gspot/configurations/general/files/v8r.yml`.