# For agents

The files an AI agent reads to build with Feitio: what each one holds and where it lives.

## Why

A good share of who builds with Feitio is an AI agent. It does not look at the page: it reads files. So every Feitio rule also exists as text, in a place the agent finds on its own.

## The files

### `AGENTS.md`

The rules for whoever changes the Feitio repository, people and agents.

-   what never to do (edit generated files, hand-written colors, components in the core); how to change tokens, icons and illustrations; the tests

[Open on GitHub](https://github.com/Made-by-MAID/feitio/blob/main/AGENTS.md)

### `skills/feitio/SKILL.md`

How to build an interface with Feitio: the short version of the guidelines, so the agent uses the system instead of inventing style.

-   the setup (CSS, fonts, icons), the rules for color, type, shape, motion and writing, and what never to do

[Open on GitHub](https://github.com/Made-by-MAID/feitio/blob/main/skills/feitio/SKILL.md)

### `tokens/`

Feitio’s values in open JSON (DTCG), readable by any tool.

-   the base and every theme, by day and at night

[Open on GitHub](https://github.com/Made-by-MAID/feitio/tree/main/tokens)

### `docs/guidelines/`

The full guidelines in Markdown, one per foundation.

-   color, type, space, shape, motion, iconography and voice

[Open on GitHub](https://github.com/Made-by-MAID/feitio/tree/main/docs/guidelines)

### `llms.txt`soon

The site map for agents, at the address they look for first: what exists and where, in text.

-   the list of pages with one line each, and an `llms-full.txt` with everything on one page

### `*.md`soon

Every site page also in Markdown, at the same address ending in `.md`.

-   the same content as the page, without the frame

Today’s `SKILL.md` does not yet have this phase’s rules (mobile first, just enough JavaScript, large screens, feedback in place, where actions live). It gets updated with Feitio’s finishing pass.

## How to use with an agent

-   Agents that read skills (like Claude Code) find Feitio’s when the `skills/feitio/` folder sits in their skills folder, in the project or on your machine.
-   Agents that read `AGENTS.md` (like Codex) read the repository’s when they work inside it.
-   For an agent that only has the web, point it to the site’s `llms.txt`: `https://feitio.bymaid.com/en/llms.txt`, or `llms-full.txt` for everything.

```shell
npx degit Made-by-MAID/feitio/skills/feitio .claude/skills/feitio
```