- 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 就会安装它。