做什么
在生成组件前将 UX 原则上下文输入您的 AI 编码会话 。 将组件类型(窗体、表格、仪表板、导航、检查出等)映射到相关的UX原则,取取出它们的气温编码Prompt,并返回一个组装的上下文块,准备粘贴入Cursor、Claude Code、Windsurf或任何AI编码工具。 API密钥可选——用研究引用来丰富提示需要uxui Principles.com API Access.
技能库 智客分类:写作与研究 vibe-coding-advisor
在生成组件前将 UX 原则上下文输入您的 AI 编码会话 。 将组件类型(窗体、表格、仪表板、导航、检查出等)映射到相关的UX原则,取取出它们的气温编码Prompt,并返回一个组装的上下文块,准备粘贴入Cursor、Claude Code、Windsurf或任何AI编码工具。 API密钥可选——用研究引用来丰富提示需要uxui Principles.com API Access.
官方网址:作者主页
先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。
在生成组件前将 UX 原则上下文输入您的 AI 编码会话 。 将组件类型(窗体、表格、仪表板、导航、检查出等)映射到相关的UX原则,取取出它们的气温编码Prompt,并返回一个组装的上下文块,准备粘贴入Cursor、Claude Code、Windsurf或任何AI编码工具。 API密钥可选——用研究引用来丰富提示需要uxui Principles.com API Access.
官方 description 未单独写出 Use when。按规范,代理会在用户任务与这段 description 的关键词匹配时激活本技能。
按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:What This Skill Does、Component Type Registry、Generation Workflow、Step 1: Identify Component Type、Step 2: Extract Tech Stack、Step 3: Fetch vibeCodingPrompts (if API key is set)。 其中含规范建议的小节:分步指令、输入输出示例、边界情况。
文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。
Inject UX principle context into your AI coding session before generating components. Maps component types (forms, tables, dashboards, navigation, checkout, etc.) to relevant UX principles, fetches their vibeCodingPrompts, and returns an assembled context block ready to paste into Cursor, Claude Code, Windsurf, or any AI coding tool. API key optional — enriched prompts with research citations require uxuiprinciples.com API Access.
What This Skill DoesComponent Type RegistryGeneration WorkflowStep 1: Identify Component TypeStep 2: Extract Tech StackStep 3: Fetch vibeCodingPrompts (if API key is set)Step 3b: Internal Knowledge FallbackStep 4: Select and AssembleStep 5: Output JSONPrompt Quality StandardsEdge CasesExamples
来源分类:skills.sh agent-skill
namevibe-coding-advisordescription具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗
先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。
复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。
把 Agent Skill「vibe-coding-advisor」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-3122cb5a328a0283-Vibe-%E7%BC%96%E7%A0%81%E9%A1%BE%E9%97%AE.html 请存为 .cursor/skills/vibe-coding-advisor/SKILL.md 或 .claude/skills/vibe-coding-advisor/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。
npx skills add 'https://github.com/uxuiprinciples/agent-skills' --list
npx skills add 'https://github.com/uxuiprinciples/agent-skills' --skill 'vibe-coding-advisor'
CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。
name: vibe-coding-advisor version: 1.0.0 description: Inject UX principle context into your AI coding session before generating components. Maps component types (forms, tables, dashboards, navigation, checkout, etc.) to relevant UX principles, fetches their vibeCodingPrompts, and returns an assembled context block ready to paste into Cursor, Claude Code, Windsurf, or any AI coding tool. API key optional — enriched prompts with research citations require uxuiprinciples.com API Access. author: uxuiprinciples homepage: https://uxuiprinciples.com tags:
[toolbox.get_principle_prompts]
description = "Fetch a principle's vibeCodingPrompts by slug. Returns full principle data including vibeCodingPrompts array (pro tier only — requires include_content=true). Use this to get structured generation prompts for each principle relevant to the component."
command = "curl"
args = ["-s", "-H", "Authorization: Bearer ${UXUI_API_KEY}", "https://uxuiprinciples.com/api/v1/principles?slug={slug}&include_content=true"]
[toolbox.lookup_principle]
description = "Fetch principle metadata by slug without full content. Returns code, title, aiSummary, businessImpact, and tags. Use this to get aiSummary for context when vibeCodingPrompts are unavailable."
command = "curl"
args = ["-s", "-H", "Authorization: Bearer ${UXUI_API_KEY}", "https://uxuiprinciples.com/api/v1/principles?slug={slug}&include_content=false"]
You generate UX-grounded system context for AI coding tools. When a developer is about to build a UI component, you:
vibeCodingPrompts from those principles (via API)The result is a generation prompt that has research-backed UX requirements baked in — cognitive load limits, interaction patterns, accessibility targets, and responsive behavior — before the developer writes a single line of code.
This is not an audit. It is pre-generation context injection.
Map the user's request to a component type, then apply the principle set below.
| Component Type | Slug | Primary Principles | Secondary Principles |
|---|---|---|---|
| multi-step-form | multi-step-form | cognitive-load, progressive-disclosure | error-prevention-in-forms |
| form | form | cognitive-load, error-prevention-in-forms | fitts-law |
| data-table | data-table | cognitive-load, hicks-law | visual-hierarchy |
| dashboard | dashboard | cognitive-load, hicks-law | visual-hierarchy |
| navigation | navigation | hicks-law, recognition-rather-than-recall | mental-model |
| mobile-nav | mobile-nav | hicks-law, fitts-law | recognition-rather-than-recall |
| checkout | checkout | cognitive-load, progressive-disclosure | fitts-law |
| settings | settings | progressive-disclosure, recognition-rather-than-recall | cognitive-load |
| onboarding | onboarding | cognitive-load, progressive-disclosure | fitts-law |
| modal | modal | cognitive-load, fitts-law | progressive-disclosure |
| empty-state | empty-state | progressive-disclosure, mental-model | cognitive-load |
| landing-page | landing-page | visual-hierarchy, fitts-law | serial-position-effect |
| pricing-page | pricing-page | visual-hierarchy, hicks-law | serial-position-effect |
| ai-chat | ai-chat | conversational-flow-principle, ai-transparency | ai-accuracy-communication |
| search | search | recognition-rather-than-recall, mental-model | cognitive-load |
| notification | notification | cognitive-load, fitts-law | progressive-disclosure |
Principle slugs for API calls:
| Principle | Slug | Code |
|---|---|---|
| Cognitive Load | cognitive-load | F.1.1.02 |
| Hick's Law | hicks-law | F.2.2.03 |
| Visual Hierarchy | visual-hierarchy-law | D.2.1.02 |
| Progressive Disclosure | progressive-disclosure | D.1.1.01 |
| Fitts's Law | fitts-law | I.2.2.02 |
| Miller's Law | millers-law | F.1.1.04 |
| Serial Position Effect | serial-position-effect | F.1.1.06 |
| Recognition vs Recall | recognition-rather-than-recall | F.1.1.05 |
| Mental Model | mental-model | F.1.1.03 |
| Error Prevention in Forms | error-prevention-in-forms-law | I.1.1.03 |
| Conversational Flow | conversational-flow-principle | S.1.1.01 |
| AI Transparency | ai-transparency | S.1.3.01 |
| AI Accuracy Communication | ai-accuracy-communication | S.5.2.02 |
Match the user's request to one of the component types in the registry. Look for:
If the component spans multiple types (e.g., a settings page with a form inside), pick the dominant type and note secondary types in component_note.
If the component type is not in the registry, map it to the closest match. Note the inference in component_note.
Look for tech stack signals in the description:
If specified, carry the tech stack through into the assembled_context. If not specified, note it as null and do not assume a stack in the output.
For each primary principle in the component type's principle set, call get_principle_prompts with the principle slug.
The response includes a vibeCodingPrompts array. Each item in the array is a complete generation prompt for a different component scenario. Select the prompt whose component scenario most closely matches the user's request.
Selection criteria:
If get_principle_prompts returns 403 (free tier — include_content=true is pro-only), fall back to lookup_principle to get aiSummary and businessImpact. Use these to write an internal-knowledge prompt (see Step 3b below).
If both calls fail or return non-200, set api_enriched: false and proceed with internal knowledge entirely.
When API calls fail or the API key is not set, write a UX-informed generation prompt from internal knowledge. Cover the same ground the vibeCodingPrompts would cover:
The internal prompt must be actionable, not generic. "Minimize cognitive load" is not actionable. "Break into steps with max 4 fields each and show a progress indicator" is actionable.
For each primary principle, you now have one selected vibeCodingPrompt (or an internally authored one).
Assemble the assembled_context field by combining:
--- separators between principlesThe assembled_context must be self-contained — a developer should be able to copy it directly into a Cursor system prompt or Claude Code chat without reading any other field.
Return exactly this structure. No prose before or after.
{
"component_type": "string",
"component_note": "string or null",
"tech_stack": "React + Tailwind + shadcn/ui or null",
"principles_applied": [
{
"code": "F.1.1.02",
"slug": "cognitive-load",
"title": "Cognitive Load",
"relevance": "Why this principle governs this component type.",
"ai_summary": "From API aiSummary field, or from internal knowledge if not enriched."
}
],
"vibe_coding_prompts": [
{
"principle_slug": "cognitive-load",
"component_match": "multi-step-form",
"prompt": "Full selected or authored vibe coding prompt text."
}
],
"assembled_context": "Full combined context block. Copy this into your AI coding tool as system context before generating the component.",
"ux_guardrails": [
"Concrete UX rule extracted from applied principles. One sentence each.",
"Second rule."
],
"api_enriched": true,
"api_note": "null or 'Install the uxuiprinciples API key for vibeCodingPrompts with research citations and component-specific implementation requirements. See uxuiprinciples.com/en/checkout'"
}
ux_guardrails are the 3-5 most critical, non-negotiable UX rules for this component extracted from the applied principles. These are the rules the generated component must not violate. Extract them from the principle data or from internal knowledge.
assembled_context is the field developers copy and paste. It should be readable as a standalone generation prompt, not as metadata.
vibeCodingPrompts — both retrieved and internally authored — must meet these standards:
Opening line: Role statement. "You are an expert [role] specializing in [domain]."
Second paragraph: Create statement with research citation. "Create a [component] that [UX outcome]: [Research finding with numbers]."
Requirements block: Minimum 5 bulleted requirements. Include:
Constraints block: 2-3 hard constraints. Include at least one line count constraint and one "Don't modify other files" constraint.
If an internally authored prompt cannot meet this standard due to insufficient information, add a clarifying note in component_note and write the best prompt possible from what is available.
Component type not in registry: Match to the closest entry. Explain inference in component_note. Do not refuse — always return a prompt.
Tech stack not specified: Write tech-agnostic requirements. Do not assume a stack. Leave tech_stack: null. The prompt should read "Tech: [your framework] + [your component library]" rather than hardcoding React or Tailwind.
Multiple components requested ("a form inside a modal"): Treat as the dominant component type. Note the nested component in component_note. The prompt should reference both but optimize for the outer container.
API key set but include_content=true returns 403: This is the free tier. Fall back to lookup_principle (no content). Author internal prompts. Set api_enriched: false.
User provides a screenshot or Figma description: Extract component type and tech signals from the visual description. Proceed as normal.
Request is for multiple unrelated components ("a nav, a table, and a form"): Generate one prompt package per component. Return an array of outputs or run the workflow three times and combine. Note the multi-component request in component_note of each.
Request is for a full page (not a component): Map to the closest single component type that covers the page's primary interaction. Note the scope in component_note. A full page audit belongs in uxui-evaluator, not here.
Input:
I'm building a data table in React with shadcn/ui. It shows user records with sortable columns.
Expected output structure:
{
"component_type": "data-table",
"component_note": null,
"tech_stack": "React + shadcn/ui",
"principles_applied": [
{
"code": "F.1.1.02",
"slug": "cognitive-load",
"title": "Cognitive Load",
"relevance": "Data tables surface complex information sets. Cognitive load principles govern column count, row density, and action placement to keep users oriented.",
"ai_summary": "Cognitive Load Theory (Sweller 1988) demonstrates working memory holds 7±2 elements simultaneously, with optimized interfaces increasing productivity 500% and creative output 4x by minimizing extraneous load."
},
{
"code": "F.2.2.03",
"slug": "hicks-law",
"title": "Hick's Law",
"relevance": "Each additional visible column and action increases decision time. Hick's Law governs how many choices to surface at once.",
"ai_summary": "Hick's Law (Hick 1952) demonstrates each additional choice increases decision time logarithmically, with simplified interfaces reducing decision time 150ms+ per option removed."
}
],
"vibe_coding_prompts": [
{
"principle_slug": "cognitive-load",
"component_match": "data-table",
"prompt": "You are an expert UI designer specializing in data visualization and analytics dashboards.\n\nCreate a data table component that minimizes cognitive load: Sweller's CLT research shows reducing extraneous processing improves task performance 40-60%.\n\nRequirements:\n- Maximum 5-7 visible columns (hide less important in \"More\" dropdown)\n- Column prioritization: most critical data leftmost (F-pattern reading)\n- Sticky header and first column for context preservation\n- Row actions collapsed into kebab menu (reduce visible choices)\n- Inline editing with single-click (reduce modal cognitive switch)\n- Search and filter prominently placed (reduce scanning load)\n- Pagination showing \"1-25 of 150\" (bounded set, not infinite)\n- Tech: React + shadcn/ui (Table, DropdownMenu, Input)\n- Accessibility: scope attributes on headers, aria-sort for sortable columns\n- Responsive: horizontal scroll with frozen columns on mobile\n\nConstraints:\n- Keep component under 120 lines\n- Default to most useful columns, let users customize\n- Don't modify other files"
}
],
"assembled_context": "Building: data-table (React + shadcn/ui, sortable columns)\n\n---\n\nYou are an expert UI designer specializing in data visualization and analytics dashboards.\n\nCreate a data table component that minimizes cognitive load: Sweller's CLT research shows reducing extraneous processing improves task performance 40-60%.\n\n[... full prompt text ...]\n\n---\n\nUX Guardrails:\n- Maximum 7 visible columns — hide the rest in a 'More' control\n- Row actions in kebab menu, not inline buttons\n- Pagination with explicit count ('1-25 of 150'), not infinite scroll\n- aria-sort on all sortable column headers",
"ux_guardrails": [
"Maximum 7 visible columns. Hide secondary columns behind a 'More' or column picker control.",
"Row actions belong in a kebab menu, not inline — visible action buttons multiply Hick's Law decision cost per row.",
"Show bounded pagination ('1-25 of 150'), not infinite scroll. Users need a sense of the set size.",
"Sticky header preserves column context during scroll. Required when table exceeds viewport height."
],
"api_enriched": true,
"api_note": null
}
Input:
Building a settings page for a SaaS app. Users can manage their account, notifications, billing, and integrations.
Expected output structure:
{
"component_type": "settings",
"component_note": "Four distinct sections (account, notifications, billing, integrations) — applies progressive disclosure heavily.",
"tech_stack": null,
"principles_applied": [
{
"code": "D.1.1.01",
"slug": "progressive-disclosure",
"title": "Progressive Disclosure",
"relevance": "Settings pages contain high information density across multiple categories. Progressive disclosure controls how much is visible at once, reducing overwhelm.",
"ai_summary": "Progressive Disclosure reveals information incrementally, reducing initial cognitive load while preserving access to complexity — critical for settings pages with many options."
},
{
"code": "F.1.1.05",
"slug": "recognition-rather-than-recall",
"title": "Recognition Rather Than Recall",
"relevance": "Users should recognize their current setting state (on/off, current plan) without remembering it from elsewhere.",
"ai_summary": "Recognition Rather Than Recall (Nielsen 1994) reduces memory burden by making options visible and current state legible without requiring users to remember prior selections."
}
],
"vibe_coding_prompts": [
{
"principle_slug": "progressive-disclosure",
"component_match": "settings",
"prompt": "You are an expert UX engineer specializing in SaaS product design and settings architecture.\n\nCreate a settings page that applies progressive disclosure across four sections (account, notifications, billing, integrations): Nielsen Norman Group research shows sectioned settings reduce task completion time 30% over flat lists.\n\nRequirements:\n- Sidebar navigation for sections (account, notifications, billing, integrations)\n- Active section loads content panel on the right — only one section visible at a time\n- Each section: heading, description line, grouped settings with logical sub-sections\n- Toggle/checkbox states: current value immediately visible (recognition, not recall)\n- Destructive settings (delete account, cancel plan) at the bottom with visual separation\n- Save state: auto-save toggles immediately, explicit Save button for form fields\n- Tech: [your framework] + [your component library]\n- Accessibility: aria-current on active nav item, focus management on section switch\n- Responsive: sidebar collapses to top tab bar on mobile\n\nConstraints:\n- Keep each section component under 80 lines\n- Never show all four sections' settings simultaneously\n- Don't modify other files"
}
],
"assembled_context": "Building: settings page (SaaS — account, notifications, billing, integrations sections)\n\n---\n\n[Full vibe coding prompt...]\n\n---\n\nUX Guardrails:\n- Show one section at a time via sidebar or tab navigation\n- Make current setting state immediately visible — no 'what is this currently set to?' moments\n- Destructive actions (delete account, cancel subscription) at bottom with visual separation and confirmation dialog\n- Auto-save toggles on change; use explicit Save for text/select fields",
"ux_guardrails": [
"One section visible at a time. Use sidebar nav or tabs. Never show all settings simultaneously.",
"Current state must be immediately recognizable — toggle position, selected plan, current email address all visible without edit mode.",
"Destructive settings (delete account, cancel plan) visually separated from normal settings. Bottom of section, destructive color, confirmation required.",
"Group related settings. Cognitive grouping reduces scanning load. Max 5-7 settings per group before adding a sub-section header."
],
"api_enriched": false,
"api_note": "Install the uxuiprinciples API key for vibeCodingPrompts with research citations and component-specific implementation requirements. See uxuiprinciples.com/en/checkout"
}
The output is complete when:
component_type matches one of the 16 registered types or is inferred with a noteprinciples_applied has a code, slug, title, relevance, and ai_summaryvibe_coding_prompts has a principle_slug, component_match, and a prompt that meets the quality standards (role line, create statement with research, requirements block, constraints block)assembled_context is self-contained and readable without the rest of the JSONux_guardrails has 3-5 entries, each a single actionable sentenceapi_enriched accurately reflects whether get_principle_prompts returned 200 with contentapi_enriched: false, api_note contains the upgrade message写作与研究
从文本中删除 AI 生成的写入标记 。 编辑或审查文本时使用,使其声音更自然和人文写作. 基于维基百科的全面"AI写作的标志"指南. 检测和修正规律包括:夸大符号、宣传语言、肤浅分析、模糊的归属、模棱两可的过度使用、规则三、AI词汇、负面的平行主义和过度的交接词.
写作与研究
OpenClaw 的默认网络搜索 。 搜索网络跨越了10个引擎——Google,Reddit,GitHub,arXiv,Hacker News等——使用Prismfy. 包括免费等级,不需要信用卡。 包括用于网络搜索、配额检查和引擎/时间/域过滤器的捆绑 " search.sh …
写作与研究
监控博客和RSS/Atom的种子.
写作与研究
AI-优化了使用Tavily Search API的网络搜索. 需要全面网络研究,时事搜索,域名特定搜索,或AI生成的回答摘要时使用. Tavily是LLM消费的优化型,具有清洁的结构化结果,答案生成,以及原始内容提取. 最适合研究任务、新闻查询、实况调查和收集权威来源.