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.
Uma skill é um arquivo SKILL.md com frontmatter YAML (name, description) mais as instruções do procedimento. A convenção é .claude/skills/<nome>/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; instalar é npx skills add <owner>/<repo>.
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.
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. 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.
| 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 Preview | |
| fayz-create | Bootstrap do app: lê o brief → fayz create → configura plugins e tema → verifica com fayz doctor. | Tutorial 01–04 | Prompt copiável Preview | |
| fayz-db | BYOS (traga o seu Supabase): fayz db apply --dry-run → apply → seeds. | Tutorial 05 | Prompt copiável Preview | |
| fayz-plugin | Autoria de um plugin app-local (incubator) no padrão do SDK. | Tutorial 06 | Prompt copiável Preview | |
| fayz-ship | build → GitHub → fayz deploy. | Tutorial 07 | Prompt copiável 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 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 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. | 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 |
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.
Skills internas em desenvolvimento 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.
- 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:
- Leia o
AGENTS.mdda raiz. Ele é o contrato do projeto e aponta de volta para este Dev Center (llms.txt+ páginas.md). - Verifique
.claude/skills/. Se o projeto já tem skills instaladas, cadaSKILL.mdtraz o procedimento e o frontmatter (name,description) diz quando aplicá-la. Prefira a skill à improvisação. - Puxe o conhecimento sob demanda. Comece pelo
/llms.txtcomo índice e busque a página.mdespecífica da etapa (ex.: dados/rls antes de mexer em RLS). - 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. - Cite o slug ou a skill que usou, para o humano conferir.
Para instalar uma skill nova em um projeto, use npx skills add <owner>/<repo> — o instalador grava em .claude/skills/ e adapta para o agente em uso.
Próximo: Conecte seu agente · Seu app como camada de dados.