# Skills

> The Mynth agent skill, a SKILL.md with task-specific references, from the oss repository.

The Mynth skill is the `skills/mynth` directory in the
[oss repository](https://github.com/mynthio/oss/tree/main/skills/mynth).
`SKILL.md` is what the agent reads first. It picks a file from `references/`
for the task at hand.

## Add it

Copy the `skills/mynth` directory into the skills folder your agent reads, and
keep `SKILL.md` and `references/` together. The repository has no install
command.

## What it covers

The skill covers image generation with `@mynthio/sdk` and the REST API,
choosing a model, browser polling with a `pat_`, webhooks, the image tools,
and destinations. It tells the agent to keep the API key on the server.

| Task                             | Reference                               |
| -------------------------------- | --------------------------------------- |
| Survey a repo before migrating   | `references/analyze-repo.md`            |
| Call the SDK                     | `references/sdk-usage.md`               |
| Call the REST API                | `references/rest-api.md`                |
| `generateImage()` in TanStack AI | `references/tanstack-ai.md`             |
| Registered webhooks              | `references/webhooks.md`                |
| Convex webhooks                  | `references/convex.md`                  |
| Browser polling with a `pat_`    | `references/public-access-tokens.md`    |
| Rate an image                    | `references/image-rating.md`            |
| Alt text                         | `references/image-alt.md`               |
| Remove a background              | `references/image-remove-background.md` |
| Deliver to your storage          | `references/destinations.md`            |

## How it picks a model

The skill never hands the agent a model to use. It tells the agent to read the
live catalog with `npx @mynthio/cli models list` or `GET /models`, filter by
what the feature needs, and let you choose from two or three candidates. It
tells the agent never to omit `model` or send `auto`, and to ask before saving
the chosen id anywhere. The id in its code samples is marked as an example.

Video, image review, and the TanStack Start helper have no reference file.
`SKILL.md` points the agent at the markdown docs for those. These docs are the
source of truth for paths and fields. See [llms.txt](https://mynth.io/docs/sdks/agents/llms-txt.md).

## Next steps

- [Agent prompt](https://mynth.io/docs/sdks/agents/agent-prompt.md): a prompt and a rule list to give the agent.
- [Webhooks](https://mynth.io/docs/concepts/webhooks.md): helpers for Next.js, TanStack Start, and Convex.