vendor-sync

GitHub

用于同步上游供应商技能包版本,包括更新锁定文件、重新验证技能、处理依赖变更及发布构建。

.agents/skills/vendor-sync/SKILL.md langchain-ai/design-agent

Trigger Scenarios

需要升级 HyperFrames、LangSmith 或 Deep Agents 等上游依赖版本时 执行 vendor-sync 命令以同步并验证 vendored skills

Install

npx skills add langchain-ai/design-agent --skill vendor-sync -g -y
More Options

Non-standard path

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

Use without installing

npx skills use langchain-ai/design-agent@vendor-sync

指定 Agent (Claude Code)

npx skills add langchain-ai/design-agent --skill vendor-sync -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": "vendor-sync",
    "description": "Move a vendored upstream (HyperFrames, LangSmith skills, Deep Agents skills) to a newer pin, re-vendor its skills unmodified, verify them, and update everything that depends on the pin."
}

Update vendored skills

Vendored skills are never edited; they are replaced from upstream at a commit and checked against skills-lock.json in CI. Each upstream's pin lives in UPSTREAMS in src/design_agent/skills_lock.py, with the skills it vendors into skills/ (runtime) and .agents/skills/ (coding agents). uv run design-agent skills sync-vendor --check-only compares every pin with its upstream's newest release (HyperFrames) or main commit (LangChain's packs).

HyperFrames

  1. Pick the release: the latest stable HyperFrames tag (never a prerelease) and its commit. Read its changelog for CLI changes (flags, renamed or deprecated commands such as validate → check).
  2. Bump the hyperframes entry's commit and release in UPSTREAMS, the hyperframes version in sandbox/render/package.json, then npm install --package-lock-only in sandbox/render/ and uv run python scripts/sync_sandbox_recipe.py (embeds the lock in setup.sh).
  3. uv run design-agent skills sync-vendor --upstream hyperframes; review git diff skills/ skills-lock.json. Check the exclusion list still catches third-party media, unlicensed fonts and bundled libraries. Upstream skills carry their own .gitignores: git add -f any locked file they hide (test_git_tracks_every_locked_file names them).
  4. Rebuild and prove: uv run design-agent sandbox build, sandbox test, uv run pytest -q -m render, uv run design-agent demo. MDA deployments need sandbox publish again, since the recipe changed.

LangSmith and Deep Agents skills

  1. Read what changed on main of langchain-ai/langsmith-skills or langchain-ai/langchain-skills since the pinned commit, then bump that entry's commit in UPSTREAMS.
  2. uv run design-agent skills sync-vendor --upstream langsmith-skills (or langchain-skills); review git diff skills/ .agents/skills/ skills-lock.json.
  3. If langsmith-trace changed, check its one-line summary in config/vendored-skills.toml still steers the deployed agent to list_traces and read_trace: its sandbox has no network and no LangSmith key, so the CLI the skill teaches cannot run there.

Every upstream

  • New or renamed runtime skills: add a one-line summary to config/vendored-skills.toml, and the folder to extend-exclude in pyproject.toml (tests fail until both match the lock). New coding-agent skills need a route in AGENTS.md (test_coding_agent_skills.py checks).
  • Prove: uv run design-agent skills verify, uv run pytest -q.
  • Record the new pin and anything that changed in NOTICE.md, docs/sources/ and CHANGELOG.md.

Version History

  • 8134d7c Current 2026-11-20 21:40

Same Skill Collection

.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-customize/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
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

Metadata

Files
0
Version
8134d7c
Hash
08cf871a
Indexed
2026-11-20 21:40

ホーム - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-21 02:41
浙ICP备14020137号-1