- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add YunYouJun/valaxy --skill valaxy -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add YunYouJun/valaxy --skill valaxy -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add YunYouJun/valaxy --skill valaxy -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add YunYouJun/valaxy --skill valaxy -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/YunYouJun/valaxy/tree/HEAD/skills/valaxy來自發布者
Next-generation static blog framework: Vue 3 + Vite + UnoCSS + file-based routing + markdown-it.
pnpm create valaxy # scaffold new site
pnpm i # MUST use pnpm
pnpm dev # dev server at localhost:4859
pnpm build # SSG build to dist/
Two config files:
site.config.ts — site metadata (title, author, social, search, comments) via defineSiteConfig()valaxy.config.ts — framework config (theme, addons, markdown, vite) via defineValaxyConfig<ThemeConfig>()theme.config.ts — theme-specific via defineThemeConfig()Posts go in pages/posts/*.md. Frontmatter controls title, date, tags, categories, cover, draft, encryption, layout, etc.
Config sources merge via defu (user wins): Default → Theme → Addons → User.
roots = [clientRoot, themeRoot, ...addonRoots, userRoot]
User components/layouts/styles override theme which overrides core — by filename matching.
File-based via vue-router/vite. Files in pages/ become routes. Layout auto-assigned:
pages/posts/** → post layoutpages/tags/** → tags layoutpages/categories/** → categories layoutOverride with layout: xxx in frontmatter.
Define in pages/collections/{name}/index.ts using defineCollection():
import { defineCollection } from 'valaxy'
export default defineCollection({
key: 'hamster',
title: 'Hamster Stories',
items: [
{ title: 'Chapter 1', key: '1' },
],
})
::: zh-CN / ::: en containers in markdownlocales/*.ymltitle: { en: 'Title', 'zh-CN': '标题' }$locale:tag.notes syntaxCreate styles/index.ts (or .scss/.css) — auto-loaded. Override CSS vars for theming.
Place .vue files in components/ — auto-registered, overrides theme/core components by name.
When working on the Valaxy core framework itself:
pnpm i # install all workspace deps
pnpm run build # build core: utils → valaxy → devtools
pnpm dev:lib # watch core packages
pnpm demo # run demo site
pnpm docs:dev # run docs site
pnpm test # unit tests (vitest)
pnpm e2e # E2E tests (playwright)
pnpm lint # eslint
pnpm typecheck # type check
When displaying repository URLs from package.json, import and use normalizeRepositoryUrl() from @valaxyjs/utils to remove the git+ prefix.
Generate or redesign a theme from a brief: use the dedicated valaxy-theme skill from this repository (pnpm dlx skills add YunYouJun/valaxy --skill valaxy-theme). It covers a runnable theme/demo, UI-library integration and verification.
Framework architecture, virtual modules, composables, components: Read references/architecture.md
Theme/addon development, post frontmatter, addon gallery: Read references/theme-addon-dev.md
>
---name: valaxydescription: >---# skills/valaxy/SKILL.md常見問題
從發布者下載 skills/valaxy/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/YunYouJun/valaxy。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。