Skip to content

feat(mcp): add agent skills for component building and token discovery #695

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
GarthDB wants to merge 16 commits into
base: main
Choose a base branch
from
Open

feat(mcp): add agent skills for component building and token discovery #695

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
a26b82d
feat(mcp): add agent skills for component building and token discovery
GarthDB Feb 10, 2026
9f3dcff
fix(changeset): fix line length in changeset description
GarthDB Feb 10, 2026
25b4c0b
docs(mcp): add SKILL.md for agent skills documentation
GarthDB Feb 10, 2026
7c091cb
fix(mcp): update SKILL.md to follow Agent Skills specification format
GarthDB Feb 10, 2026
7d8a44b
feat(spectrum-design-data-mcp): refactor code quality, add agent skil…
GarthDB Feb 10, 2026
2ca6d60
test(mcp): add code coverage with c8
GarthDB Feb 10, 2026
a2f3747
feat(mcp): add implementation mapping tools and refactor workflows
GarthDB Feb 11, 2026
e6c1634
fix(mcp): correct copyright year from 2026 to 2024
GarthDB Feb 12, 2026
b49da40
docs(mcp): agent-skills folder rename, docs, and error messages
GarthDB Feb 12, 2026
7390703
fix(mcp): update test assertions for new tool counts after rebase
GarthDB Feb 27, 2026
50d2c0b
Merge remote-tracking branch 'origin/main' into feat/agent-skills
GarthDB Mar 26, 2026
b3731eb
fix(ci): pin node 20.17.0 in .prototools and update ai.md for agent s…
GarthDB Mar 26, 2026
d3a19bb
fix(ci): add pnpm 10.17.1 to .prototools
GarthDB Mar 26, 2026
4da64b2
fix(changeset): wrap long line in agent-skills-enhancements.md
GarthDB Mar 26, 2026
8cb0827
fix(changeset): rewrap lines to stay under 100 chars
GarthDB Mar 26, 2026
f605411
chore: migrate from Cursor to Claude Code configuration
GarthDB Mar 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .changeset/agent-skills-enhancements.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"@adobe/spectrum-design-data-mcp": patch
---

Improved Agent Skills with better folder naming (`agent-skills/`), comprehensive documentation
including quick start examples, state management guide, accessibility checklist, and enhanced
error messages with actionable next steps.
8 changes: 8 additions & 0 deletions .changeset/agent-skills-feature.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
"@adobe/spectrum-design-data-mcp": minor
---

Added Agent Skills for component building and token discovery.
Agent Skills are markdown guides that help AI agents orchestrate
MCP tools into complete workflows. Includes Component Builder and
Token Finder skills, plus new workflow-oriented MCP tools.
0 .cursor/plans/size-property-analysis.md → .claude/plans/size-property-analysis.md
View file
Open in desktop
File renamed without changes.
0 ...r/plans/token-options-mapping-analysis.md → ...e/plans/token-options-mapping-analysis.md
View file
Open in desktop
File renamed without changes.
20 changes: 10 additions & 10 deletions .cursor/skills/enhance-sync-pr/SKILL.md → .claude/skills/enhance-sync-pr/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,14 +58,14 @@ Or full graph: `moon ci` (same as GitHub Actions).

### Failure map (what to suggest)

| Symptom | Likely cause | Suggestion | | |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | --------------- |
| `checkComponentProps` lists token names | Missing or wrong `component` on entries in `color-component.json`, `layout-component.json`, or `icons.json` | Set `component` to match token name prefix (see [`packages/tokens/test/checkComponentProps.js`](../../../packages/tokens/test/checkComponentProps.js)). | | |
| Schema / `color-set` errors | `sets` missing `light`, `dark`, or **`wireframe`** | Align with [`schemas/token-types/color-set.json`](../../../packages/tokens/schemas/token-types/color-set.json). | | |
| `verifyDesignDataSnapshot` / snapshot mismatch | Validation report changed vs golden file | Paths 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` / `uuid` | Invalid token shape | Fix per [`token-file.json`](../../../packages/tokens/schemas/token-file.json) and failing AVA tests. | | |
| Alias / renamed / manifest | Broken refs or manifest drift | Fix aliases; run `moon run tokens:buildManifest`. | | |
| Changeset lint on PR | Bad frontmatter | Valid `---` / \`"[**@adobe/spectrum-tokens**](https://github.com/adobe/spectrum-tokens)": patch | minor | major\` / body. |
| Symptom | Likely cause | Suggestion | | |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | - |
| `checkComponentProps` lists token names | Missing or wrong `component` on entries in `color-component.json`, `layout-component.json`, or `icons.json` | Set `component` to match token name prefix (see [`packages/tokens/test/checkComponentProps.js`](../../../packages/tokens/test/checkComponentProps.js)). | | |
| Schema / `color-set` errors | `sets` missing `light`, `dark`, or **`wireframe`** | Align with [`schemas/token-types/color-set.json`](../../../packages/tokens/schemas/token-types/color-set.json). | | |
| `verifyDesignDataSnapshot` / snapshot mismatch | Validation report changed vs golden file | Paths 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` / `uuid` | Invalid token shape | Fix per [`token-file.json`](../../../packages/tokens/schemas/token-file.json) and failing AVA tests. | | |
| Alias / renamed / manifest | Broken refs or manifest drift | Fix aliases; run `moon run tokens:buildManifest`. | | |
| Changeset lint on PR | Bad frontmatter | Valid `---` / `"@adobe/spectrum-tokens": patch \| minor \| major` / body. | | |

Re-run targeted tasks after each fix until green.

Expand Down Expand Up @@ -108,7 +108,7 @@ GITHUB_TOKEN=... node src/cli.js generate \

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:
Commit using the **source implementer's** git identity so changelog "Thanks @…" matches design work:

```bash
git config user.email '<email>'
Expand All @@ -132,4 +132,4 @@ 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](https://github.com/adobe/spectrum-design-data/issues/615), [#593](https://github.com/adobe/spectrum-design-data/issues/593)). Early PRs used hand-written “Design motivation” + “Token diff” in the changeset body — the generator now standardizes that shape.
Well-formed examples: merged sync PRs with `token-changeset-generator`-style changesets and enriched bodies (e.g. [#615](https://github.com/adobe/spectrum-design-data/issues/615), [#593](https://github.com/adobe/spectrum-design-data/issues/593)). Early PRs used hand-written "Design motivation" + "Token diff" in the changeset body — the generator now standardizes that shape.
3 changes: 0 additions & 3 deletions .cursor/mcp.json
View file
Open in desktop

This file was deleted.

265 changes: 0 additions & 265 deletions .cursor/rules
View file
Open in desktop

This file was deleted.

Loading
Loading