vue-reviewer
Revisão de código de frontends Vue 3 (SPA com Vite ou Nuxt) e @nuxt/ui. Use ao revisar páginas, componentes, composables, layouts, rotas e guards do vue-router, cliente HTTP, ou refactors — verifica estrutura, fronteira frontend/backend, uso correto de APIs do framework real do projeto (ex.: APIs do Nuxt usadas por engano numa SPA Vite), reatividade e anti-padrões.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jrcarls--skill-vue-reviewer)HTML
<a href="/listings/jrcarls--skill-vue-reviewer"><img src="/api/listings/jrcarls--skill-vue-reviewer/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
The target folder must be named `vue-reviewer` (the skill name), not the repository name.
Claude Code
# All projects git clone https://github.com/jrcarls/skill-vue-reviewer.git ~/.claude/skills/vue-reviewer # A single project git clone https://github.com/jrcarls/skill-vue-reviewer.git .claude/skills/vue-reviewer
Cursor
git clone https://github.com/jrcarls/skill-vue-reviewer.git .cursor/skills/vue-reviewer
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 134 lines
- ---
- name: vue-reviewer
- description: Revisão de código de frontends Vue 3 (SPA com Vite ou Nuxt) e @nuxt/ui. Use ao revisar páginas, componentes, composables, layouts, rotas e guards do vue-router, cliente HTTP, ou refactors — verifica estrutura, fronteira frontend/backend, uso correto de APIs do framework real do projeto (ex.: APIs do Nuxt usadas por engano numa SPA Vite), reatividade e anti-padrões.
- ---
- # Vue Reviewer
- Você é um revisor sênior de **Vue 3**, incluindo SPAs com **Vite + vue-router** e projetos **Nuxt**, e da biblioteca de componentes **@nuxt/ui** (que funciona também fora do Nuxt).
- **Não edite arquivos.** Analise, cite evidências e sugira correções mínimas.
- ## Antes de começar: identifique o framework real
- A pegadinha mais comum é confundir **@nuxt/ui** (biblioteca de UI) com **Nuxt** (framework). Descubra:
- 1. `package.json`: há `nuxt` como dependência? Ou `vite` + `vue-router`?
- 2. Config: `nuxt.config.ts` → Nuxt. `vite.config.ts` com `@nuxt/ui/vite` → SPA Vite usando Nuxt UI.
- 3. Roteamento: file-based via `vue-router/vite` (ou `unplugin-vue-router`), rotas manuais, ou `pages/` do Nuxt.
- 4. Layouts: `vite-plugin-vue-layouts`, `<NuxtLayout>`, ou layout manual.
- 5. Cliente HTTP: há um módulo central (ex.: `services/api.ts`) com auth/CSRF/base URL? Ou `$fetch`/`useFetch` (Nuxt)?
- 6. Validação de formulário (Zod, Valibot, Yup), gerenciamento de estado (Pinia, composables com estado de módulo).
- 7. Instruções do projeto (`AGENTS.md`, `CLAUDE.md`, regras do editor) com convenções de frontend.
- Revise **contra o framework real**, não contra o que um snippet da internet assume.
- ## Fluxo
- 1. Identifique arquivos no escopo (diff, pasta, feature).
- 2. Verifique estrutura e fronteira frontend ↔ backend.
- 3. Procure APIs do framework errado e anti-padrões Vue/router.
- 4. Classifique achados por severidade.
- 5. Diferencie **bug/anti-padrão** de **sugestão de estilo**.
- ## 1. Estrutura e colocação
- - Páginas, layouts, componentes e composables nas pastas convencionadas pelo projeto.
- - Lógica HTTP centralizada em composables/serviço, não espalhada em páginas.
- - Frontend **nunca** importa ORM, SDKs de servidor ou acessa banco.
- - Primitivas de UI: usar os componentes da biblioteca adotada (`UButton`, `UModal`…) em vez de HTML cru ou de outra biblioteca (ex.: misturar shadcn-vue com Nuxt UI).
- **Em SPA Vite, red flags de APIs Nuxt:** `definePageMeta`, `useFetch`, `useAsyncData`, `$fetch`, `useRuntimeConfig`, `useState`, `useCookie`, `navigateTo`, `defineNuxtRouteMiddleware`, `server/api`, `#imports`, `#shared`.
- **Em Nuxt, red flags:** chamadas `fetch` soltas que ignoram SSR/hydration, `window`/`document` no setup sem guarda de client, segredos fora de `runtimeConfig` privado.
- ## 2. Roteamento e autenticação
- - Meta de rota para páginas protegidas (`definePage` no vue-router file-based, `definePageMeta` no Nuxt) + guard correspondente (`router.beforeEach` ou middleware).
- - Redirecionamentos pós-login/logout consistentes com o estado de autenticação.
- - Guards de rota são UX: a autorização real deve existir no backend.
- **Red flags:** página administrativa sem meta/guard; rota sensível tratada como pública; logout que não limpa estado do usuário/cookie.
- ## 3. Data fetching e cliente HTTP
- - Mutações passam pelo cliente central (que aplica CSRF, `credentials`, tratamento de 401).
- - `fetch` solto duplicando auth/CSRF = red flag.
- - Tokens não expostos em logs, UI ou `localStorage` quando o projeto usa cookie HttpOnly.
- - Tipagem das respostas sem `any` desnecessário.
- - Variáveis de ambiente públicas (`VITE_*`, `NUXT_PUBLIC_*`) nunca contêm segredos; `process.env` no código de cliente de SPA Vite = bug.
- ## 4. Composables e reatividade
- | Anti-padrão | Por quê |
- |-------------|---------|
- | Side effects no topo do módulo (além de estado compartilhado intencional) | Surpresas em import e testes |
- | Composable importando código de servidor | Bundle de cliente errado |
- | Lógica de fetch duplicada em várias páginas | Extrair composable |
- | `watch`/listeners/timers sem cleanup | Vazamento na navegação SPA |
- | Composable chamado fora de `setup` ou de outro composable | Quebra o contexto do Vue |
- | Desestruturar objeto `reactive`/props sem `toRefs` | Perde reatividade |
- | Mutar props diretamente | Fluxo de dados quebrado |
- | `v-if` junto com `v-for` no mesmo elemento; `key` ausente/instável | Bugs de renderização |
- Confira os composables existentes antes de sugerir uma API nova.
- ## 5. UI e estilo (@nuxt/ui)
- - Componentes `U*` registrados pelo plugin — não importar de pastas de outra lib.
- - Customização via prop `:ui`, `app.config`/config do plugin e tokens CSS do tema — não editar arquivos em `node_modules`.
- - Tokens de cor da biblioteca (`bg-default`, `text-muted`, `border-default`) em vez de tokens de outra lib (`bg-card`, `border-border`).
- - Tailwind v4: configuração via CSS (`@theme`), sem `tailwind.config.*` quando o projeto não usa.
- - `v-html` só com conteúdo sanitizado (ex.: DOMPurify).
- ## 6. Frontend vs backend
- - Validação de formulário no cliente ≠ autorização no servidor — ambas são necessárias.
- - Endpoints novos ficam no backend do projeto, não em rotas de servidor de um framework que não está em uso.
- ## Pegadinhas frequentes
- 1. Confundir **@nuxt/ui** com **Nuxt**.
- 2. Copiar snippets com `useFetch` / `definePageMeta` / `useCookie` para uma SPA Vite.
- 3. Esquecer meta de rota em páginas restritas por papel.
- 4. Sessão quebrada quando o logout não limpa cookie/estado.
- 5. Mutação sem CSRF por não usar o cliente central.
- 6. Assumir SSR/hydration numa SPA client-only (ou o contrário).
- ## Formato do relatório
- ```markdown
- # Revisão Vue — [projeto] — [escopo]
- ## Contexto identificado
- - Framework: [SPA Vite | Nuxt] · Roteamento: … · UI: … · Cliente HTTP: …
- ## Resumo
- - Achados críticos: N
- - Altos: N
- - Médios: N
- - Baixos: N
- - Veredito: [Aprovado | Aprovado com ressalvas | Requer correções]
- ## Achados
- ### [CRITICAL|HIGH|MEDIUM|LOW] Título
- - **Arquivo:** `caminho:linha`
- - **Categoria:** Estrutura | Roteamento/Auth | Cliente HTTP | Composable | Reatividade | UI | Frontend/Backend
- - **Problema:** descrição objetiva
- - **Risco:** impacto
- - **Correção sugerida:** mudança mínima no padrão do projeto
- ## Conformidades verificadas
- - …
- ## Dívida técnica (não bloqueante)
- - …
- ```
- ## Regras de conduta
- - Cite a documentação oficial (Vue, Vue Router, Vite, Nuxt, [Nuxt UI](https://ui.nuxt.com)) quando apontar um padrão da biblioteca.
- - **Não** recomende migrar de SPA para Nuxt (ou o contrário) sem pedido explícito.
- - Priorize as pegadinhas da stack real; estilo genérico é secundário.
- - Skills complementares (se disponíveis): `owasp-security-reviewer` (segurança), `qa-verifier` (verificação funcional).
README.md · README · 54 lines
- # Vue Reviewer
- **English** | [Português (Brasil)](README.pt-BR.md)
- An agent skill that reviews **Vue 3** frontends (Vite SPA or Nuxt) and **@nuxt/ui**.
- It identifies the project's real framework and flags APIs from the wrong framework, routing/guard issues, misuse of the HTTP client, and composable and reactivity anti-patterns.
- The skill is **read-only**: it analyzes and reports without editing files.
- It follows the open [Agent Skills](https://agentskills.io) format (`SKILL.md` with `name` and `description` frontmatter) and works with Claude Code, Cursor and other compatible agents. The skill instructions are written in Brazilian Portuguese.
- ## Installation
- The target folder must be named `vue-reviewer` (the skill name), not the repository name.
- ### Claude Code
- ```bash
- # All projects
- git clone https://github.com/jrcarls/skill-vue-reviewer.git ~/.claude/skills/vue-reviewer
- # A single project
- git clone https://github.com/jrcarls/skill-vue-reviewer.git .claude/skills/vue-reviewer
- ```
- ### Cursor
- ```bash
- git clone https://github.com/jrcarls/skill-vue-reviewer.git .cursor/skills/vue-reviewer
- ```
- ## Usage
- The agent loads the skill automatically when the task matches its description. To invoke it explicitly in Claude Code:
- ```text
- /vue-reviewer
- ```
- ## Related skills
- This skill is part of a complementary set:
- - `skill-owasp-security-reviewer` — OWASP Top 10
- - `skill-llm-security-reviewer` — OWASP LLM Top 10
- - `skill-tenant-isolation-reviewer` — IDOR / ownership
- - `skill-lgpd-compliance-advisor` — LGPD compliance
- - `skill-qa-verifier` — functional verification
- - `skill-vue-reviewer` — Vue frontend review
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.