> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Skill Istruzioni pronte che insegnano al tuo agente di codice come svolgere i compiti comuni di supastack nel modo atteso dal kit. ## Cosa sono le skill supastack include Agent Skill: istruzioni brevi e mirate che il tuo agente di codice carica quando un lavoro corrisponde. Invece di indovinare le convenzioni del kit a ogni prompt, l'agente segue gli stessi passaggi per funzionalità, pagamenti, modifiche al database e test. Le skill seguono il formato aperto Agent Skills, quindi funzionano in Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI e altri agenti compatibili. ## Dove vivono le skill Le skill vivono in `.agents/skills/`, una cartella per skill con un `SKILL.md` dentro. Copie identiche sono in `.claude/skills/` per Claude Code. ## Quali agenti le leggono Codex, Cursor, GitHub Copilot, Gemini CLI e OpenCode leggono `.agents/skills/`. Claude Code legge `.claude/skills/`. Il tuo agente sceglie una skill automaticamente quando la richiesta corrisponde alla sua descrizione — oppure la nomini: «use the `database-schema-change` skill». ## Quali repository le includono Il repository all-platforms include tutte le skill. I repository web, mobile e desktop includono le skill pertinenti; le skill di test end-to-end e di CI vengono fornite solo con il repository all-platforms. ## Setup e ambiente Skill per avviare, distribuire e configurare il kit. - **Setup dell'ambiente locale** (`local-environment-setup`) — per avviare o riparare l'ambiente locale: primo clone, .env mancante o rotto, Postgres, migrazioni o porte. - **Deploy e variabili d'ambiente** (`deploy-and-env-vars`) — per il deploy, la scelta di un hosting o l'aggiunta o modifica di una variabile d'ambiente. - **Aggiungere una dipendenza** (`adding-a-dependency`) — per aggiungere, aggiornare, spostare o rimuovere una dipendenza npm, o quando la CI fallisce il controllo licenze o audit. - **Aggiornare da upstream** (`upgrading-from-upstream`) — per portare una release più recente di supastack in un prodotto costruito su di essa. ## Costruire funzionalità Skill per aggiungere superficie di prodotto su ogni piattaforma. - **Aggiungere una funzionalità web** (`add-a-web-feature`) — per una pagina o una sezione di prodotto con dati, server actions, navigazione e test propri. - **Aggiungere un endpoint API** (`add-an-api-endpoint`) — per aggiungere o modificare un endpoint pubblico /api/v1, la sua documentazione OpenAPI o gli scope delle API key. - **Aggiungere un componente UI** (`add-a-ui-component`) — per una sezione, un blocco, un controllo di form o un componente riusabile che segue le regole di stile del kit. - **Cambiare tema o stile** (`change-the-theme-or-style`) — per cambiare l'aspetto del prodotto: stile di design, pack di colori, densità, raggio, font o layout. - **Aggiungere una pagina marketing o un post** (`add-a-marketing-page-or-blog-post`) — per aggiungere o modificare una pagina pubblica, una pagina prezzi, una pagina legale, un post del blog o una guida docs. - **Aggiungere una schermata mobile** (`add-a-mobile-screen`) — per aggiungere o modificare una schermata nell'app mobile Expo. - **Aggiungere una capacità desktop** (`add-a-desktop-capability`) — per modificare l'app desktop Tauri: finestra, tray, shortcut globale o aggiornamenti automatici. - **Aggiungere una notifica** (`add-a-notification`) — per una notifica in-app, una notifica push o un elemento del digest. ## Auth e pagamenti Skill per accesso, fatturazione e piani. - **Aggiungere un metodo di auth** (`add-an-auth-method`) — per modificare l'accesso: provider social, magic link, codici email, passkey o due fattori. - **Aggiungere un provider di pagamento** (`add-a-payment-provider`) — per attivare un provider di fatturazione o scrivere un nuovo adapter con checkout, portale clienti e webhook. - **Cambiare piani e prezzi** (`change-plans-and-pricing`) — per aggiungere, rinominare o riprezzare un piano: prezzi, trial, seat, entitlement, limiti d'uso o crediti. ## Dati e integrazioni Skill per schema, IA, job, email, storage e traduzioni. - **Modifica dello schema del database** (`database-schema-change`) — per aggiungere o modificare una tabella, colonna, indice o relazione e generare la migrazione. - **Aggiungere una funzionalità IA** (`add-an-ai-feature`) — per una chiamata a un modello, uno strumento di chat o agente, un task IA durevole, budget o bring-your-own-key. - **Aggiungere un job in background** (`add-a-background-job`) — per lavoro che gira dopo una richiesta, su timer o per workspace. - **Aggiungere o modificare un'email** (`add-or-edit-an-email`) — per aggiungere o cambiare un'email transazionale o il provider che la invia. - **Usare il file storage** (`use-file-storage`) — per upload o file salvati come avatar, loghi o allegati. - **Aggiungere traduzioni** (`add-translations`) — per aggiungere o modificare testo visibile, tradurlo o aggiungere una locale. ## Qualità e rilascio Skill per test, verifica, review e CI. - **Scrivere unit test** (`writing-unit-tests`) — per scrivere o correggere unit test o integration test Vitest. - **Scrivere test e2e** (`writing-e2e-tests`) — per aggiungere o correggere test end-to-end Playwright, in locale o in CI. - **Verificare le modifiche** (`verify-changes`) — prima di un handoff, commit o pull request, per scegliere ed eseguire i controlli giusti. - **Debuggare un run CI fallito** (`debugging-a-failing-ci-run`) — quando un run di GitHub Actions fallisce e devi trovare e correggere la causa. - **Fare review di una PR** (`reviewing-a-pr`) — per revisionare una pull request o un diff su correttezza, isolamento dei workspace e convenzioni. ## Aggiungere le tue Aggiungi una cartella il cui nome corrisponde al `name` nel suo frontmatter, con un `name` e una `description` che dicono quando usarla. Copiala anche in `.claude/skills/` così ogni agente la trova. ## Successivo [Costruisci con un agente di codice](https://supastack.dev/it/docs/web/agents.md)