菜单
Translate and generate documentation for the monorepo with the @aphrody-code/doc-ai CLI (Google Gemini backend, offline fallback). Use when asked to "translate the docs", "generate an API guide for a Lit component", "sync docs to another language", or "run doc-ai".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Develop AI-powered applications using Genkit in Node.js/TypeScript. Use when the user asks about Genkit, AI agents, flows, or tools in JavaScript/TypeScript, or when encountering Genkit errors, validation issues, type errors, or API problems.
Apply Google's design language to a UI. Load whenever the user wants something to look or feel like a Google product, including requests like "apply Google design style", "make it look like a Google product", "Google-style UI", "design.google guidance", "Google design principles", "Google Sans typography", "Product Sans", "Gemini visual language", "the Gemini sparkle / gradient look", "Material You expressiveness", or any question about how Google approaches color, type, motion, and brand across its products (Search, Gemini, Workspace, Pixel). This is the language layer above the Material 3 spec; for exact M3 token values use the sibling skill m3-docs.
Scaffold a self-contained Material Design 3 md-* web component and/or its React wrapper. Use when the user says: "create an M3 component", "scaffold a Material Design 3 <X> component", "build an md-* web component", "make a new Material component", "wrap a component in React", "add md-<x> to the monorepo".
User-invoked fix skill. Auto-correct Material Design 3 violations in a codebase. Use when asked to "fix M3 violations", "auto-correct Material Design issues", "make this M3-compliant", "clean up MUI residue", "fix hardcoded colors", "fix sx on md components", or "fix wrong icon names".
Turn a natural-language design brief into a Material Design 3 React scaffold with @aphrody-code/m3-design. Use when asked to "scaffold a screen from a description", "generate an M3 layout from a brief", "design compiler", "brief to JSX", or "make an M3 prototype/dashboard/deck from this prompt".
Load this skill whenever the user wants to design or build UI that looks Material Design 3 / Material You / Google-style, including requests like "make this look Material", "apply M3 styling", "which color role or token should I use", "design a Google-style component", "is this on-brand for Material", "M3 color system", "how do I use MD3 tokens on the web", "style this with Material Design", "use M3 elevation or shape", "add M3 motion or animation", "pick the right surface level", "make it look like Google Workspace", or any question about MD3 semantics, color roles, type scale, elevation, shape, motion easing, state layers, or window size classes.
| name | m3-doc-ai |
| description | Translate and generate documentation for the monorepo with the @aphrody-code/doc-ai CLI (Google Gemini backend, offline fallback). Use when asked to "translate the docs", "generate an API guide for a Lit component", "sync docs to another language", or "run doc-ai". |
@aphrody-code/doc-ai is the doc-as-code CLI of the monorepo: it translates Markdown,
generates Lit component API guides, and bulk-syncs every docs/ folder — backed by
Google Gemini (via the Vercel AI SDK @ai-sdk/google + ai), with a deterministic
static fallback when no credentials are set (so it stays runnable offline and in CI).
doc-ai translate <file_or_dir> [lang] # translate one .md or a dir (recursive); default lang fr
doc-ai generate <ts_file> [out_file] # generate a Lit component API guide from source
doc-ai sync [lang] # translate every monorepo docs/ folder
doc-ai --help
From the monorepo root the wrappers are wired in:
bun run docs:translate <file_or_dir> [lang]
bun run docs:ai # sync
Translations are written next to each source as <name>.<lang>.md (default fr) —
this is why the repo carries *.fr.md siblings.
| Env var | Effect |
|---|---|
GEMINI_API_KEY | GOOGLE_API_KEY | Enable Gemini-backed generation/translation. |
DOC_AI_MODEL | Override the model (default gemini-2.5-flash). |
DOC_AI_GEMINI_BASE_URL | Override the Generative Language API base URL. |
DOC_AI_REQUEST_TIMEOUT_MS | Per-request network timeout (default 60000). |
Without credentials, generate/translate fall back to a deterministic static
template — the pipeline never hard-fails for lack of a key.
docs/*.md was written in English -> doc-ai translate docs/new.md fr.md-* component shipped -> doc-ai generate packages/material-web/<comp>/internal/<comp>.ts
to draft its API guide.bun run docs:ai to refresh every translation.Never paste an API key into a tracked file; pass it via the environment only.
Develop in-repo: cd packages/doc-ai && bun run build && bun run test.