Agent Skills › langchain-ai/design-agent › design-agent-customize

design-agent-customize

GitHub

指导如何定制 Design Agent,包括创建运行时技能、调整指令与设计规范、配置 MCP 工具及模型预算。涵盖从需求分析到测试验证的完整流程,确保 Agent 行为符合团队规范与业务需求。

.agents/skills/design-agent-customize/SKILL.md langchain-ai/design-agent

触发场景

需要为 Design Agent 添加新的设计交付物或工作流 需要修改 Agent 的设计准则、检查规则或连接外部工具

安装

npx skills add langchain-ai/design-agent --skill design-agent-customize -g -y
更多选项

非标准路径

npx skills add https://github.com/langchain-ai/design-agent/tree/main/.agents/skills/design-agent-customize -g -y

不安装直接使用

npx skills use langchain-ai/design-agent@design-agent-customize

指定 Agent (Claude Code)

npx skills add langchain-ai/design-agent --skill design-agent-customize -a claude-code -g -y

安装 repo 全部 skill

npx skills add langchain-ai/design-agent --all -g -y

预览 repo 内 skill

npx skills add langchain-ai/design-agent --list

SKILL.md

Frontmatter
{
    "name": "design-agent-customize",
    "description": "Change what Design Agent knows and does. Teach it a new deliverable with a runtime skill, change its instructions, design doctrine or checks, connect MCP servers and tools, or change models and cost caps. Use when someone wants it to make something new, follow a new rule, or use another tool."
}

Customize Design Agent

Every kind of knowledge has one home. Find the owner before editing, so a fix lands once and every asset after it follows:

The change Its home
Brand facts: colours, fonts, logos, voice, graphic language workspace/brand/ (brand-onboarding)
A deliverable or workflow the team asks for often a runtime skill, skills/<name>/SKILL.md
Doctrine for every visual: hierarchy, type, colour, charts skills/design-wiki/references/
Identity, delivery and approval rules, how it talks instructions.md (a budget test fails past about 8k tokens)
A rule a machine can count a check in workspace/tools/
A tool or data source an MCP server in config/mcp.toml
Which model plays which role, effort, budgets .env settings; Models

Add a runtime skill

Start with the graphic the team asks for every week.

  1. Read two skills close to it (skills/stills/, skills/thumbnails/) and skills/design-wiki/SKILL.md.
  2. Create skills/<name>/SKILL.md as a real folder one level deep (MDA does not follow symlinks there). Frontmatter: name is the folder; description says when to use it, in the words people use when they ask. Body: what good looks like, sizes, steps, the checks to run. Put depth in references/ and keep the body small. Text only: binary files (fonts, images) go in skill-binaries/<name>/, because Context Hub takes only UTF-8 text; the stager puts them back beside the skill in the sandbox.
  3. No brand facts, colours or libraries from a CDN in the skill: the brand pack supplies them.
  4. uv run pytest -q tests/unit/test_taste_skills.py tests/unit/test_media_skills.py checks frontmatter, size, links, and that every tool, script and check it names exists.
  5. Try it with the request people actually send: uv run design-agent ask "…". Look at the files.
  6. Add an eval task if it matters (design-agent-evals), then redeploy (design-agent-deploy).

Vendored skills (HyperFrames and LangSmith, listed in skills-lock.json) are never edited: override them in a sibling skill of ours, or send the change upstream.

Instructions, doctrine and checks

  • Phrase rules as defaults with a reason, or as checks with evidence. A rule about the model is temporary; retest it when the model changes and delete what the new model outgrows.
  • A rule a machine can count belongs in code, as a check, not in prose.
  • After editing, run uv run pytest -q, then compare before and after with the evals.

Tools

  • MCP servers: copy config/mcp.example.toml to config/mcp.toml and declare servers. Locally, header values come from the environment (headers_env); on MDA a server that needs credentials names a workspace connection (connection), owned by the deployment or each person (owner). The example file has presets for Notion, Linear, GitHub, Figma and others (integrations). MDA serves HTTP and SSE only. Paper is configured with PAPER_*, not here (Paper).
  • Media keys: OPENAI_API_KEY (images), ELEVENLABS_API_KEY (voice, music, sound effects), GROQ_API_KEY (transcription).
  • A new host tool is code in src/design_agent/tools/: keys stay on the host and results drop into the sandbox as files. Follow the change discipline in AGENTS.md.

Models and cost

uv run design-agent config set DESIGN_AGENT_MODEL=provider:model, then uv run design-agent test model. DESIGN_AGENT_JOB_BUDGET_USD makes the agent ask before passing a budget; DESIGN_AGENT_HELPER_EFFORT_CAP caps helpers' effort. More: Customization.

版本历史

  • 8134d7c 当前 2026-11-20 21:39

同 Skill 集合

.agents/skills/brand-onboarding/SKILL.md
.agents/skills/deep-agents-core/SKILL.md
.agents/skills/deep-agents-memory/SKILL.md
.agents/skills/deep-agents-orchestration/SKILL.md
.agents/skills/design-agent-deploy/SKILL.md
.agents/skills/design-agent-evals/SKILL.md
.agents/skills/design-agent-onboarding/SKILL.md
.agents/skills/design-agent-troubleshoot/SKILL.md
.agents/skills/design-agent-update/SKILL.md
.agents/skills/langsmith-evaluator/SKILL.md
.agents/skills/vendor-sync/SKILL.md
skills/brand-design/SKILL.md
skills/content-brief/SKILL.md
skills/data-viz/SKILL.md
skills/design-wiki/SKILL.md
skills/faceless-explainer/SKILL.md
skills/film-breakdown/SKILL.md
skills/general-video/SKILL.md
skills/gif-edit/SKILL.md
skills/hyperframes-core/SKILL.md
skills/hyperframes-creative/SKILL.md
skills/hyperframes-keyframes/SKILL.md
skills/image-generation/SKILL.md
skills/image-ops/SKILL.md
skills/launch-film/SKILL.md
skills/media-production/SKILL.md
skills/motion-direction/SKILL.md
skills/music-to-video/SKILL.md
skills/paper-design/SKILL.md
skills/pr-to-video/SKILL.md
skills/reference-study/SKILL.md
skills/remotion-to-hyperframes/SKILL.md
skills/slideshow/SKILL.md
skills/sound/SKILL.md
skills/stills/SKILL.md
skills/storyboard/SKILL.md
skills/thumbnails/SKILL.md
skills/visual-verify/SKILL.md
.agents/skills/managed-deep-agents/SKILL.md
skills/embedded-captions/SKILL.md
skills/hyperframes-animation/SKILL.md
skills/hyperframes-audio/SKILL.md
skills/hyperframes-cli/SKILL.md
skills/hyperframes-registry/SKILL.md
skills/hyperframes/SKILL.md
skills/media-use/SKILL.md
skills/motion-graphics/SKILL.md

元信息

文件数
0
版本
8134d7c
Hash
7169c260
收录时间
2026-11-20 21:39

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-21 05:03
浙ICP备14020137号-1