Skill

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.