fantasia-i18n
Manages vue-i18n messages and locale structure for Fantasia Archive. Use when adding or changing user-facing strings, locale files under src/i18n, or markdown-backed documents wired into i18n.
Best use case
fantasia-i18n is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Manages vue-i18n messages and locale structure for Fantasia Archive. Use when adding or changing user-facing strings, locale files under src/i18n, or markdown-backed documents wired into i18n.
Teams using fantasia-i18n should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/fantasia-i18n/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How fantasia-i18n Compares
| Feature / Agent | fantasia-i18n | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Manages vue-i18n messages and locale structure for Fantasia Archive. Use when adding or changing user-facing strings, locale files under src/i18n, or markdown-backed documents wired into i18n.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Fantasia Archive — i18n ## Setup - **Plugin**: `vue-i18n` v9. - **Locale registry**: `src/i18n/index.ts` exports locale keys (e.g. `en-US`, `de`) and merges each locale module. - **TypeScript**: global message schema augmentation lives in **`src/boot/i18n.ts`** (`declare module 'vue-i18n'`). Under **`yarn lint:typescript`**, **`tsc`** may report **TS2665** against the ESM `module` resolution; the boot file documents a **`@ts-expect-error`** for that line. Keep **`eslint-disable @typescript-eslint/no-empty-object-type`** on the augmentation block (typescript-eslint v8 rule name). See [eslint-typescript.mdc](../../rules/eslint-typescript.mdc). ## English structure (`src/i18n/en-US/`) - **`index.ts`**: Composes the default export — global `documents` (imported `.md` strings), `app`, page keys (`ErrorNotFound`, …), and nested `T_*` modules for menus, dialogs, and components. - **Component/dialog strings**: Prefer dedicated `T_<feature>.ts` files under `en-US/components/...` or `en-US/dialogs/...` and import them into `index.ts` for a clear tree. - **Markdown documents**: Live under `en-US/documents/` as `.md` files; imported in `index.ts` and often passed through `specialCharacterFixer` from `src/i18n/specialCharactersFixer.ts`. ## Storybook integration - For Storybook mocks/loaders, import focused non-markdown `T_*` modules directly (for example `en-US/components/.../T_*.ts`) instead of importing `en-US/index.ts`. - Reason: full locale entrypoints pull markdown `documents/*.md`, which can break Storybook/Vite import analysis unless extra markdown handling is configured. - If Storybook stories need document content (`documents.*`), provide explicit placeholder strings (for example lorem ipsum) in `.storybook/preview.ts` rather than importing markdown files. ## Adding strings 1. Choose the right namespace (global vs component-specific `T_*` module). 2. Add keys in TypeScript modules or inline in `index.ts` for small additions. 3. Mirror structure in other active locales (`de`, etc.) when those are maintained. ## Related - [fantasia-markdown-dialogs](../fantasia-markdown-dialogs/SKILL.md) for rendering markdown in dialogs.
Related Skills
fantasia-worldbuilding-domain
Aligns AI suggestions with Fantasia Archive as a worldbuilding database manager: projects, documents, and in-app concepts. Use when designing UX, data models, menus, or copy that should match the product purpose.
fantasia-testing
Runs and extends Fantasia Archive tests: Vitest unit tests vs Playwright component and E2E tests, including rebuild-before-Playwright rules and file naming. Use when writing tests, debugging CI, or when the user mentions Vitest, Playwright, component tests, or e2e.
fantasia-sqlite-main
Designs SQLite usage in Fantasia Archive’s Electron main process: file locations under userData, native sqlite3 module constraints, and migrations. Use when editing electron-main database code, schema, or persistence paths.
fantasia-release-build
Produces production Electron builds for Fantasia Archive with electron- builder and Quasar. Use when changing build scripts, packaging, or publish flags, or when the user asks how to ship the desktop app.
fantasia-quasar-vue
Builds Vue 3 + Quasar UI for Fantasia Archive: layouts, pages, router, Pinia, and boot files. Use when editing .vue files, Quasar components, routes, or stores under src/.
fantasia-plan-documents
Creates and updates local plan documents in .cursor/plans with required timestamp and package version metadata in both file body and filename.
fantasia-markdown-dialogs
Implements or edits markdown-backed dialogs using Quasar QMarkdown and i18n- sourced document strings. Use when changing DialogMarkdownDocument, help docs, or changelog/license content shown in-app.
fantasia-electron-preload
Extends or fixes renderer-facing Electron APIs exposed through the preload script and contextBridge. Use when adding IPC-like surface area, typing window.faContentBridgeAPIs, or editing files under src-electron/ contentBridgeAPIs.
fantasia-electron-main
Works on Fantasia Archive Electron main process: app lifecycle, window management, platform tweaks, and native integrations. Use when editing electron-main.ts, src-electron/mainScripts/, or main-side tests.
fantasia-dev-setup
Sets up and runs Fantasia Archive locally using Yarn, Node.js 22.22 or newer, and Quasar Electron mode. Use when installing dependencies, choosing dev vs production build commands, or when the user mentions environment setup, CLI, or first run.
fantasia-changelog-en-us
Maintains the English in-app changelog at src/i18n/en-US/documents/changeLog.md in strict sync with package.json version, without any automatic version bumping. Changelog text must be user- or release-relevant only—never internal QA (lint/build/test runs, “all gates passed”). Use after substantive app, UX, or user-facing docs changes, or when the user asks for release notes.
git-conventional-commits
Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs). Proposes commits one at a time and waits for explicit user approval before each git commit. Use when the user asks to commit, split commits, stage by topic, or use conventional / semantic commit messages.