design-agent-update

$npx mdskill add langchain-ai/design-agent/design-agent-update

The brand pack (`workspace/brand/`), licensed fonts (`private-fonts/`) and `.env` are Git-ignored, so an update never touches them. The team's own skills and instruction edits can conflict.

SKILL.md

.github/skills/design-agent-updateView on GitHub ↗
---
name: design-agent-update
description: Bring a fork or clone of Design Agent up to date with the upstream repository while keeping the team's brand, skills and edits, rebuild what changed, and redeploy safely. Use when someone asks to update, upgrade or pull the latest Design Agent.
---

# Update from upstream

The brand pack (`workspace/brand/`), licensed fonts (`private-fonts/`) and `.env` are Git-ignored,
so an update never touches them. The team's own skills and instruction edits can conflict.

1. `git status`. Commit the person's local work first, or ask; never use a bare `git stash`.
2. Add the remote once: `git remote add upstream https://github.com/langchain-ai/design-agent.git`.
   Then `git fetch upstream` and read the new entries in `CHANGELOG.md` for breaking changes.
3. Merge `upstream/main` into the person's branch. In conflicts, keep their skills and instruction
   edits and take upstream's code; ask when a conflict touches both.
4. `uv sync`, `uv run design-agent doctor`, `uv run pytest -q`, `uv run design-agent skills verify`.
5. If `sandbox/setup.sh` changed: `uv run design-agent sandbox build && uv run design-agent sandbox test`;
   for Managed Deep Agents, also `uv run design-agent sandbox publish` (the snapshot name follows the
   recipe's hash).
6. Try the update on a test copy (`uv run mda deploy --name design-agent-test`), then
   deploy the team's agent after a yes ([design-agent-deploy](../design-agent-deploy/SKILL.md)).

More from langchain-ai/design-agent

SkillDescription
brand-onboardingBuild the active brand pack in workspace/brand/ from a brand guide, website, files or a Paper file, validate it, and have a person review it.
data-vizCharts, stat cards, flywheels and diagrams (flows, architectures, hierarchies) rendered on brand from a JSON spec to PNG and SVG. Use for any visual whose job is numbers or relationships, including restyling an attached chart or diagram.
design-agent-customizeChange 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.
design-agent-deployPut Design Agent in a team's Slack. Deploy it to Managed Deep Agents (one command, managed Slack app) or self-host it with Docker Compose, verify it with a real request, ship updates, and keep a separate test copy. Use when someone wants the agent running for their team.
design-agent-evalsFind out whether a change made Design Agent better or worse. Run the eval set or a few tasks before and after against the same model, read the reports, look at the files, and turn a real request that went wrong into a task. Use after changing instructions, skills, checks or models, or when someone asks how good it is.
design-agent-onboardingInstall and configure Design Agent, add a brand, connect Paper, choose MDA or self-hosting, and diagnose setup without exposing credentials.
design-agent-troubleshootDiagnose Design Agent when something fails. Setup, a render, a deploy, Slack or a model call. Run doctor and the connection tests, read logs and traces, match the symptom to its fix, and never print credentials. Use when a command errors, a reply never comes, or a file looks wrong.
design-wikiDesign doctrine to weigh on any visual. Hierarchy, typography, colour, layout, platform sizes, chart and diagram principles, and the review rubric critics score against.
embedded-captions>
faceless-explainerTurn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.