Agent skill

Enhance Sync PR

by adobe in adobe/spectrum-design-data

Enhances auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch tokens-sync/patch-spectrum2-from-main, author mrcjhicks).

Apache-2.0Auto-check passedFrontend & Design

Install Enhance Sync PR

skills CLI
$ npx skills add adobe/spectrum-design-data --skill enhance-sync-pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install adobe/spectrum-design-data enhance-sync-pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/adobe/spectrum-design-data.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/enhance-sync-pr .claude/skills/enhance-sync-pr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
enhance-sync-pr
GitHub stars
155
Token cost
~2.3k tokens
SKILL.md length
430 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Enhances auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch tokens-sync/patch-spectrum2-from-main, author mrcjhicks).

  • Works in 5 steps: Resolve source PR → Diagnose CI (suggest fixes; user… → PR title and body → …
  • Fixing sync PRs
  • SKILL.md covers When this applies, Repo and tools, 1. Resolve source PR and 2. Diagnose CI (suggest fixes;…, plus 4 more sections
  • Calls pnpm, git and gh; reaches github.com; needs GITHUB_TOKEN

What it does

Enhance Sync PR is an agent skill from adobe/spectrum-design-data. Enhances auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch tokens-sync/patch-spectrum2-from-main, author mrcjhicks). Diagnoses CI failures, suggests fixes, creates changesets with token-changeset-generator, updates PR title/body, and attributes the original Tokens Studio implementer. Use when fixing sync PRs, PRs from tokens-sync, enhance-sync-pr workflow gaps, or missing changesets on studio syncs.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Failing and flaky tests. It works with GitHub Actions. The repository describes itself as: Design data, including design tokens, component schemas, and tooling for Spectrum, Adobe's design system. The licence is Apache-2.0.

When your agent uses it

  • Fixing sync PRs
  • PRs from tokens-sync
  • Enhance-sync-pr workflow gaps
  • Missing changesets on studio syncs

Example prompts

  • “Use the enhance-sync-pr skill to enhance auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch…”
  • “/enhance-sync-pr”

Requirements

  • A credential in GITHUB_TOKEN

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Resolve source PR
  2. Diagnose CI (suggest fixes; user approves edits)
  3. PR title and body
  4. Changeset + git attribution
  5. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit dc75d47. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm
    • git
    • gh
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GITHUB_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Enhance Sync PR loads about 2.3k tokens when it runs. Until then it costs about 114 tokens; SKILL.md has 430 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~114
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from adobe/spectrum-design-data at commit dc75d47, republished under its Apache-2.0 licence (© adobe). 430 words, ~2,282 tokens.

Download SKILL.mdSave it as .claude/skills/enhance-sync-pr/SKILL.md (or your agent's skills folder).
name
enhance-sync-pr
description
Enhances auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch tokens-sync/patch-spectrum2-from-main, author mrcjhicks). Diagnoses CI failures, suggests fixes, creates changesets with token-changeset-generator, updates PR title/body, and attributes the original Tokens Studio implementer. Use when fixing sync PRs, PRs from tokens-sync, enhance-sync-pr workflow gaps, or missing changesets on studio syncs.

Enhance sync PR (Tokens Studio → spectrum-design-data)

When this applies

  • PR opened by mrcjhicks from tokens-sync/patch-spectrum2-from-main (or similar sync branch).
  • Body links to github.com/adobe/spectrum-tokens-studio-data/actions/runs/….
  • CI red after sync (validation, snapshot, component props, wireframe, etc.).
  • Changeset missing; title still feat: updates from spectrum-tokens-studio-data or duplicated feat: Feat:.

Repo and tools

1. Resolve source PR

From the design-data PR body, take the spectrum-tokens-studio-data Actions run URL or the Tokens Studio PR link.

bash
gh pr view <N> --repo adobe/spectrum-design-data --json body,title,headRefName,url

If only the run URL exists, resolve merged PR from that run (same logic as extract-source-pr-info).

Record:

  • Source PR URL (e.g. https://github.com/adobe/spectrum-tokens-studio-data/pull/297)
  • Source author (user.login from that PR) for attribution
bash
gh api repos/adobe/spectrum-tokens-studio-data/pulls/<num> --jq '{title, author: .user.login, body}'

2. Diagnose CI (suggest fixes; user approves edits)

Check out the PR branch with full history (fetch-depth: 0) so tdiff can compare to main.

Run in order:

bash
moon run tokens:validateDesignData
moon run tokens:verifyDesignDataSnapshot
cd packages/tokens && pnpm ava

Or full graph: moon ci (same as GitHub Actions).

Failure map (what to suggest)
SymptomLikely causeSuggestion
checkComponentProps lists token namesMissing or wrong component on entries in color-component.json, layout-component.json, or icons.jsonSet component to match token name prefix (see packages/tokens/test/checkComponentProps.js).
Schema / color-set errorssets missing light, dark, or wireframeAlign with schemas/token-types/color-set.json.
verifyDesignDataSnapshot / snapshot mismatchValidation report changed vs golden filePaths in the snapshot are relative to packages/tokens/. After moon run sdk:build, run migrate snapshot from packages/tokens/ so paths match moon run tokens:verifyDesignDataSnapshot: cd packages/tokens && ../../sdk/target/debug/design-data migrate snapshot ./src --output ./snapshots/validation-snapshot.json --schema-path ./schemas --exceptions-path ./naming-exceptions.json.
Token file / $schema / uuidInvalid token shapeFix per token-file.json and failing AVA tests.
Alias / renamed / manifestBroken refs or manifest driftFix aliases; run moon run tokens:buildManifest.
Changeset lint on PRBad frontmatterValid --- / "@adobe/spectrum-tokens": patch | minor | major / body.

Re-run targeted tasks after each fix until green.

Show full SKILL.md (137 more words)Show less

3. PR title and body

  • Title: One conventional prefix. Strip a leading feat: / Feat: (and similar) from the source title, then use feat: <clean title> (avoid feat: Feat: …).
  • Body template:
markdown
## Token updates from Spectrum Tokens Studio Data

**Original implementer:** @<github-login>

**Source PR:** [#<n> <title>](<url>)

**Automated sync via:** [GitHub Actions run](<run-url>)

### Source description

<paste or summarize source PR body / motivation>

---

<keep existing automated footer if present>

Use gh pr edit <N> --repo adobe/spectrum-design-data --title "..." --body-file body.md.

4. Changeset + git attribution

Generate changeset (requires GITHUB_TOKEN for API rate limits):

bash
cd tools/token-changeset-generator && pnpm install --frozen-lockfile
GITHUB_TOKEN=... node src/cli.js generate \
  --tokens-studio-pr 'https://github.com/adobe/spectrum-tokens-studio-data/pull/<num>' \
  --spectrum-tokens-pr 'https://github.com/adobe/spectrum-design-data/pull/<N>' \
  --source-author '<login>'

Bump type is inferred from diff (e.g. deletions → major, additions → minor).

Commit using the source implementer’s git identity so changelog "Thanks @…" matches design work:

bash
git config user.email '<email>'
git config user.name '<display name>'
git add .changeset/*.md
git commit -m "chore: add changeset for <short summary>" -m "Co-authored-by: <name> <email>"

If the commit author is already the implementer, Co-authored-by is optional but harmless.

5. Verify

bash
moon run tokens:validateDesignData
moon run tokens:verifyDesignDataSnapshot
cd packages/tokens && pnpm ava
pnpm changeset-lint check .changeset/*.md

Push the branch; confirm CI and changeset-bot on the PR.

Reference: prior manual PRs

Well-formed examples: merged sync PRs with token-changeset-generator-style changesets and enriched bodies (e.g. #615, #593). Early PRs used hand-written "Design motivation" + "Token diff" in the changeset body — the generator now standardizes that shape.

© adobe, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/enhance-sync-pr of adobe/spectrum-design-data.

Open the folder on GitHubat commit dc75d47

Compare with similar skills

Enhance Sync PR next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Enhance Sync PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Enhance Sync PR this skilladobe/spectrum-design-data155—~2.3kAutomated safety check: PassApache-2.0
Actions ManagerCommunity-Access/accessibility-agents421—~904Automated safety check: PassMIT
Pester Failure AnalysisPowerShell/PowerShell56k—~5.1kAutomated safety check: PassMIT
Debug Playwright Prowquay/quay2.8k—~2.2kAutomated safety check: PassApache-2.0
CI Failure Triage and RepairChachamaru127/claude-code-harness3.2k1 repos~1.1kAutomated safety check: NotesMIT
GreptimeDB Fuzz CI Failure InvestigationGreptimeTeam/greptimedb6.7k—~4.4kAutomated safety check: PassApache-2.0

Similar skills

  • Actions Manager

    Community-Access/accessibility-agents

    GitHub Actions: workflow runs, logs, re-runs and CI failure triage.

    421 GitHub stars~904 tokensUpdated 14 days ago
    DevOps & CloudAuto-check passed
  • Pester Failure Analysis

    PowerShell/PowerShell

    Investigates failing Pester tests in PowerShell CI jobs by following a six-step workflow from pull request status to documented fix recommendations.

    56k GitHub stars~5.1k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Deep-dive diagnosis of a Playwright test failure already isolated to one Quay Prow/OpenShift CI run: downloads its GCS artifacts (results.json, JUnit, build/pod logs, Jaeger traces), classifies real…

    2.8k GitHub stars~2.2k tokensUpdated today
    Testing & QAAuto-check passed
  • CI Failure Triage and Repair

    Chachamaru127/claude-code-harness

    Diagnoses failing CI pipelines and tests, deciding first whether the test or the implementation is at fault, and hands hard cases to a dedicated fixer subagent.

    3.2k GitHub starsUsed in 1 repo~1.1k tokens
    DevOps & CloudAuto-check: notes
  • Diagnoses a failed GreptimeDB fuzz CI job by pulling its GitHub Actions logs and fuzz artifacts, then matching the evidence to the local source code.

    6.7k GitHub stars~4.4k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Investigates a failed Opik end-to-end test from CI, TestOps or a local run, decides regression versus flake, and proposes a fix without editing tests.

    22k GitHub stars~1.8k tokensUpdated today
    Testing & QAAuto-check passed

More from adobe/spectrum-design-data

  • S2 Docs

    adobe/spectrum-design-data

    Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components.

    155 GitHub stars~868 tokensUpdated 5 days ago
    Auto-check passed
  • Design Data

    adobe/spectrum-design-data

    Look up Spectrum design tokens, component schemas, and design-system decisions when building with or extending Adobe Spectrum.

    155 GitHub stars~1.2k tokensUpdated 5 days ago
    Auto-check passed
  • Design Data Agent

    adobe/spectrum-design-data

    Validate, query, resolve, diff, and author spec-conformant design tokens and components using the design-data MCP tools against a local dataset.

    155 GitHub stars~2k tokensUpdated 5 days ago
    Auto-check passed
  • Docs Voice Tone

    adobe/spectrum-design-data

    Reviews docs-site prose (articles, spec pages, READMEs) against Spectrum's voice principles (Clear, Genuine, Concise, Upfront), adapted for public/reference docs rather than in-product UI strings.

    155 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed

Works with

Questions about Enhance Sync PR

What does Enhance Sync PR do?

Enhances auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch tokens-sync/patch-spectrum2-from-main, author mrcjhicks). Enhance Sync PR is an agent skill from adobe/spectrum-design-data. Enhances auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch tokens-sync/patch-spectrum2-from-main, author mrcjhicks).

When should I use Enhance Sync PR?

Enhance Sync PR fits situations like: fixing sync PRs; PRs from tokens-sync; enhance-sync-pr workflow gaps; missing changesets on studio syncs.

How do I install Enhance Sync PR in Claude Code?

Run `npx skills add adobe/spectrum-design-data --skill enhance-sync-pr -a claude-code`. Or copy the skill folder (.claude/skills/enhance-sync-pr in adobe/spectrum-design-data) into .claude/skills/enhance-sync-pr in your project. Claude Code loads it when a task matches its description.

How do I install Enhance Sync PR in Codex?

Run `npx skills add adobe/spectrum-design-data --skill enhance-sync-pr -a codex`. Or copy the skill folder (.claude/skills/enhance-sync-pr in adobe/spectrum-design-data) into .agents/skills/enhance-sync-pr in your project. Codex loads it when a task matches its description.

Can I use Enhance Sync PR in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add adobe/spectrum-design-data --skill enhance-sync-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/enhance-sync-pr, .gemini/skills/enhance-sync-pr, .github/skills/enhance-sync-pr and .opencode/skills/enhance-sync-pr in your project.

What does Enhance Sync PR need to run?

Going by SKILL.md and its folder, Enhance Sync PR needs the command-line tools its instructions call (pnpm, git, gh and node) and credentials named GITHUB_TOKEN. Our summary lists: A credential in GITHUB_TOKEN.

Does Enhance Sync PR access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Enhance Sync PR safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Enhance Sync PR use?

Enhance Sync PR is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Enhance Sync PR use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Enhance Sync PR?

Skills that share tags, products or a category with Enhance Sync PR: Actions Manager (Community-Access/accessibility-agents, 421 stars), Pester Failure Analysis (PowerShell/PowerShell, 56k stars), Debug Playwright Prow (quay/quay, 2.8k stars) and CI Failure Triage and Repair (Chachamaru127/claude-code-harness, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Enhance Sync PR?

adobe (a GitHub organization) maintains it in adobe/spectrum-design-data, which has 155 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 2, 2026.

Source: adobe/spectrum-design-data on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.