About vue-best-practices
Vue Best Practices is a rulebook skill for addressing common Vue 3 anti-patterns in production applications. It guides coding agents through selecting relevant rules, making minimal changes, and checking project behavior and quality commands.
Key features
- 01Vue 3 anti-pattern guidance
- 02Rule selection by issue
- 03Incremental safe changes
- 04Project-specific state patterns
- 05Lint, test, and build checks
Use cases
- 01Fix common Vue 3 anti-patterns
- 02Review code against repository rules
- 03Keep production fixes narrowly scoped
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ frankiglesias/ vue-best-practices --skill vue-best-practicesAfter installing, type/vue-best-practicesin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
AGENTS.mdrules/avoid-any-in-public-component-apis.mdavoid-deep-watchers.mdavoid-fetch-in-mounted.mdavoid-global-component-registration.mdavoid-importing-vue-compiler-macros.mdavoid-mutable-singletons.mdavoid-mutating-props.mdcancel-stale-requests.mdcleanup-side-effects.mddefer-third-party-scripts.mdfollow-eslint-format-contract.mdguard-browser-apis-on-server.mdhandle-optional-data-safely.mdisolate-direct-dom-access.mdlazy-load-routes-and-heavy-components.mdmove-data-logic-to-composables.mdprefer-computed-for-derived-state.mdprefer-tree-shakable-imports.mdprevent-hydration-mismatch.mdprevent-request-waterfalls.mdsplit-large-reactive-objects.mdstabilize-v-for-keys.mdtype-composables-and-emits.mduse-onerrorcaptured-boundaries.mdDetails
From the project READMEVue Best Practices
Use this skill as a rulebook for fixing common Vue 3 anti-patterns in production apps.
Workflow
- Open
AGENTS.md. - Select only the relevant rule files from
rules/. - Apply the smallest safe change that resolves the issue.
- Re-check behavior and run the project's lint, test, and build checks.
Repository Guardrails
- Use Vue 3 Composition API with
<script setup lang="ts">. - Follow the existing state-management pattern already used by the project (Vuex, Pinia, etc.).
- Do not create new global components.
- Do not add comments unless the user explicitly asks for them.
- Do not import Vue compiler macros (
defineProps,defineEmits,defineExpose,withDefaults) fromvue. - Match ESLint style defaults in this repo: semicolons, single quotes, trailing commas for multiline, 2-space indent.
Output Expectations
- Explain which rules were applied and why.
- Prefer composables and pure utilities over ad-hoc component logic.
- Keep changes incremental; avoid broad rewrites unless asked.
Comments
Markdown supported