# Skills: procedimentos para o seu agente Um app Fayz dá ao seu agente quatro camadas de contexto, e cada uma responde a uma pergunta diferente. O **`AGENTS.md`** é o *contrato* — as regras e convenções do projeto. O **`llms.txt`** (mais as páginas `.md`) é o *conhecimento* — o mapa e a referência do SDK. A **CLI** (`fayz create`, `fayz db`, `fayz deploy`) é a *execução* — as ações reprodutíveis. E as **skills** são os *procedimentos*: sequências prontas que o agente segue passo a passo em vez de improvisar. A direção da Fayz é não reescrever tudo do zero — o ecossistema reaproveita skills que já existem. As **skills oficiais Fayz vêm primeiro** (são o trilho do fluxo da CLI); as **skills da comunidade** entram depois, para cobrir qualidade de UI, banco e testes. {% callout type="tip" %} Uma **skill** é um arquivo `SKILL.md` com frontmatter YAML (`name`, `description`) mais as instruções do procedimento. A convenção é `.claude/skills//SKILL.md` — funciona no Claude Code e, via adaptadores do instalador, também em Cursor, Codex, Copilot, Windsurf, Gemini, Cline e Zed. O diretório aberto é o [skills.sh](https://www.skills.sh/); instalar é `npx skills add /`. {% /callout %} ## Skills oficiais Fayz — o trilho A metodologia Fayz vive como cinco skills, uma por etapa da jornada — descobrir, criar, dar dados, estender, publicar. Elas seguem a mesma ordem do fluxo da CLI e da trilha do [Tutorial](/pt-BR/docs/tutorial). {% callout type="info" %} **Estado honesto:** hoje as skills oficiais são **prompts copiáveis** — você cola o bloco no agente e ele executa o procedimento. O `/fayz-descoberta` completo, pronto para colar, está em [Setup agêntico](/pt-BR/docs/setup-agentico#o-fayz-descoberta-completo). O **empacotamento como skills instaláveis** (instalar por `npx skills add` e chamar por nome) está chegando — ainda não minta para o seu agente que já dá para instalá-las. {% /callout %} | Skill | O que faz | Etapa | Status | | --- | --- | --- | --- | | **/fayz-descoberta** | Entrevista de descoberta de produto, uma pergunta por vez; escreve o `PRODUCT-BRIEF.md`. | Antes do tutorial | Prompt copiável {% badge status="preview" %} | | **fayz-create** | Bootstrap do app: lê o brief → `fayz create` → configura plugins e tema → verifica com `fayz doctor`. | [Tutorial 01](/pt-BR/docs/tutorial/01-criar-o-app)–[04](/pt-BR/docs/tutorial/04-adicionar-um-plugin) | Prompt copiável {% badge status="preview" %} | | **fayz-db** | BYOS (traga o seu Supabase): `fayz db apply --dry-run` → `apply` → seeds. | [Tutorial 05](/pt-BR/docs/tutorial/05-dados-reais-com-supabase) | Prompt copiável {% badge status="preview" %} | | **fayz-plugin** | Autoria de um plugin app-local (incubator) no padrão do SDK. | [Tutorial 06](/pt-BR/docs/tutorial/06-seu-proprio-plugin) | Prompt copiável {% badge status="preview" %} | | **fayz-ship** | build → GitHub → `fayz deploy`. | [Tutorial 07](/pt-BR/docs/tutorial/07-publicar) | Prompt copiável {% badge status="preview" %} | O `PRODUCT-BRIEF.md` que a `/fayz-descoberta` escreve é a memória do projeto: a `fayz-create` lê dele para gerar o app certo, com os plugins e o tema certos, sem você repetir o contexto. ## Skills da comunidade — reaproveite antes de escrever Depois do trilho oficial, o seu agente ganha muito com skills abertas já mantidas por terceiros. Todas estão no [skills.sh](https://www.skills.sh/) e são código aberto no GitHub. Instale só o que a etapa pede. | Skill | Autor | Para quê no contexto Fayz | Instalar | | --- | --- | --- | --- | | **ui-ux-pro-max** | nextlevelbuilder | UI de storefronts e admins: banco local de 84 estilos, 192 paletas e 74 pares tipográficos, com workflows `--design-system` e um `search.py`. **Recomendada** para desenhar o visual antes de mexer no `theme`. | `npx skills add nextlevelbuilder/ui-ux-pro-max-skill` | | **frontend-design** | anthropics | Qualidade geral de front-end e boas práticas de componentes — útil ao editar telas dos plugins. | `npx skills add anthropics/skills` | | **web-design-guidelines** | vercel-labs | Diretrizes de design web (acessibilidade, layout, hierarquia) para revisar páginas de app. | `npx skills add vercel-labs/agent-skills` | | **vercel-react-best-practices** | vercel-labs | Padrões de React/Next para o código de app e plugins incubator. | `npx skills add vercel-labs/agent-skills` | | **supabase-postgres-best-practices** | supabase | Modelagem Postgres, índices e RLS — **recomendada** para o BYOS: casa com [RLS e multi-tenant](/pt-BR/docs/dados/rls) e com o `fayz db apply`. | `npx skills add supabase/agent-skills` | | **supabase** | supabase | Operar o Supabase pelo agente (schema, queries, migrações) — complementa o Supabase MCP do [Setup agêntico](/pt-BR/docs/setup-agentico#mcps). | `npx skills add supabase/agent-skills` | | **browser-use** | browser-use | Testes de browser de ponta a ponta — dirigir o app e conferir um fluxo real depois do `fayz doctor`. | `npx skills add browser-use/browser-use` | | **find-skills** | vercel-labs | Meta-skill: o agente descobre outras skills relevantes no diretório. | `npx skills add vercel-labs/skills` | {% callout type="tip" %} Duas escolhas que valem por padrão: **ui-ux-pro-max** para o visual de storefronts e admins, e **supabase-postgres-best-practices** para quando você conectar o seu próprio banco. As duas encaixam direto nas etapas de tema e de dados do tutorial. {% /callout %} ## Skills internas em desenvolvimento {% badge status="preview" %} Estas skills estão no roadmap da Fayz — ainda **não** disponíveis, listadas aqui para você saber o que vem: - **conceito-financeiro** — modelagem financeira nos módulos (contas, lançamentos, conciliação). - **integrations** — conectar Google Calendar, Stripe e afins pela espinha de conectores; veja [Conectores e canais](/pt-BR/docs/ia/conectores-e-canais). - **module-building** — elevar a qualidade de um plugin ao padrão de marketplace. ## Para agentes: como descobrir e aplicar skills Se você é um agente abrindo um projeto Fayz, siga esta ordem: 1. **Leia o `AGENTS.md` da raiz.** Ele é o contrato do projeto e aponta de volta para este Dev Center (`llms.txt` + páginas `.md`). 2. **Verifique `.claude/skills/`.** Se o projeto já tem skills instaladas, cada `SKILL.md` traz o procedimento e o frontmatter (`name`, `description`) diz quando aplicá-la. Prefira a skill à improvisação. 3. **Puxe o conhecimento sob demanda.** Comece pelo [`/llms.txt`](/llms.txt) como índice e busque a página `.md` específica da etapa (ex.: [dados/rls](/pt-BR/docs/dados/rls) antes de mexer em RLS). 4. **Case skill com etapa.** Descoberta/bootstrap/dados/plugin/ship → skill oficial Fayz correspondente. UI → `ui-ux-pro-max`. Postgres/RLS → `supabase-postgres-best-practices`. Teste de fluxo → `browser-use`. 5. **Cite o slug ou a skill que usou**, para o humano conferir. Para instalar uma skill nova em um projeto, use `npx skills add /` — o instalador grava em `.claude/skills/` e adapta para o agente em uso. --- Próximo: [Conecte seu agente](/pt-BR/docs/ia/conecte-seu-agente) · [Seu app como camada de dados](/pt-BR/docs/ia/seu-app-como-camada-de-dados).