Skip to content

feat(skills): add 5 skills from vercel-labs/agent-skills#589

Merged
samuv merged 8 commits intomainfrom
vercel-skills
Apr 30, 2026
Merged

feat(skills): add 5 skills from vercel-labs/agent-skills#589
samuv merged 8 commits intomainfrom
vercel-skills

Conversation

@samuv
Copy link
Copy Markdown
Contributor

@samuv samuv commented Apr 30, 2026

Summary

Add packaging specs for 5 of the 7 skills shipped by vercel-labs/agent-skills (MIT-licensed via README.md), pinned to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of 2026-04-30) at dockyard version 0.1.0. Each spec follows the existing mattpocock/skills template (e.g. skills/tdd/spec.yaml).

Skills added

  • React / Next.js (4): vercel-composition-patterns, vercel-react-best-practices, vercel-react-native-skills, vercel-react-view-transitions
  • Vercel platform (1): vercel-cli-with-tokens

Skill names match the name: field in each upstream SKILL.md frontmatter to avoid ambiguity in the agent`s skill list and to mirror what Vercel publishes.

Skills intentionally excluded

CI's skill-security-scan surfaced structural (non-allowlistable) blocking findings on two upstream skills, dropped in a follow-up commit:

  • deploy-to-vercel: upstream ships an Archive.zip containing executable scripts (deploy.sh, deploy-codex.sh) plus macOS resource-fork metadata. Triggers HIDDEN_EXECUTABLE_SCRIPT, ARCHIVE_CONTAINS_EXECUTABLE, LOW_ANALYZABILITY.
  • web-design-guidelines: upstream SKILL.md delegates rules to a main-branch GitHub raw URL via WebFetch with no version pin and no allowed-tools. Triggers LLM_PROMPT_INJECTION (CRITICAL), LLM_SUPPLY_CHAIN_ATTACK, LLM_UNAUTHORIZED_TOOL_USE.

Both can be revisited once upstream removes the bundled archive and pins/scopes the fetched URL respectively.

The upstream README.md also references vercel-deploy-claimable and react-native-guidelines, but those folders dont actually exist at this commit (the README is slightly stale). The functional replacement for the latter — react-native-skills` — is included.

Allowlist

vercel-labs/agent-skills declares MIT in README.md but does not ship a LICENSE file at the repository root. Four of the five remaining skills (vercel-composition-patterns, vercel-react-best-practices, vercel-react-native-skills, vercel-react-view-transitions) embed license: MIT directly in their SKILL.md frontmatter, so they ship without an allowlist entry. vercel-cli-with-tokens allowlists MANIFEST_MISSING_LICENSE with a rationale thats explicit about the missing root LICENSE` file.

Test plan

  • Local validation via dockhand validate-skill --config skills/<name>/spec.yaml for all 5 retained specs (Status: VALID across the board, file counts match upstream).
  • CI skill-security-scan passes on the 5 retained specs (4 clean, 1 with allowlisted MANIFEST_MISSING_LICENSE).
  • CI validate-skills matrix passes for the 5 retained configs.
  • CI build-skill-artifacts (dry-run on PR) succeeds.

Made with Cursor

samuv added 7 commits April 30, 2026 16:14
…skills

Pin to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of
2026-04-30) at dockyard version 0.1.0. Upstream SKILL.md frontmatter
declares license: MIT.

React composition patterns that scale — compound components, lifted
state, internal composition — for avoiding boolean prop proliferation.

Verified locally via `dockhand validate-skill` (Status: VALID, 14 files).
…skills

Pin to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of
2026-04-30) at dockyard version 0.1.0. Upstream SKILL.md frontmatter
declares license: MIT.

React and Next.js performance optimization guidelines from Vercel
Engineering (70 rules across 8 categories, prioritized by impact).

Verified locally via `dockhand validate-skill` (Status: VALID, 76 files).
…kills

Pin to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of
2026-04-30) at dockyard version 0.1.0. Upstream SKILL.md frontmatter
declares license: MIT.

React Native and Expo best practices for performant mobile apps —
16 rules across 7 sections (performance, layout, animation, images,
state, architecture, platform).

Verified locally via `dockhand validate-skill` (Status: VALID, 42 files).
…t-skills

Pin to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of
2026-04-30) at dockyard version 0.1.0. Upstream SKILL.md frontmatter
declares license: MIT.

Implement smooth, native-feeling animations with React`s View Transition
API (`<ViewTransition>`, `addTransitionType`, CSS view transition
pseudo-elements, Next.js integration).

Verified locally via `dockhand validate-skill` (Status: VALID, 8 files).
Pin to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of
2026-04-30) at dockyard version 0.1.0.

Deploy applications and websites to Vercel — preview by default, with a
path to a long-term git-push deploy setup.

Allowlists MANIFEST_MISSING_LICENSE because vercel-labs/agent-skills
declares MIT in README.md but does not include a LICENSE file at the
repository root, and this skill`s SKILL.md frontmatter does not embed an
SPDX license identifier.

Verified locally via `dockhand validate-skill` (Status: VALID, 4 files).
Pin to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of
2026-04-30) at dockyard version 0.1.0.

Deploy and manage Vercel projects via the CLI using token-based auth
instead of `vercel login`.

Allowlists MANIFEST_MISSING_LICENSE because vercel-labs/agent-skills
declares MIT in README.md but does not include a LICENSE file at the
repository root, and this skill`s SKILL.md frontmatter does not embed an
SPDX license identifier.

Verified locally via `dockhand validate-skill` (Status: VALID, 1 file).
Pin to commit ce3e64e468f8fa09a2d075d102771838061fdac0 (main as of
2026-04-30) at dockyard version 0.1.0.

Review UI code for Web Interface Guidelines compliance — accessibility,
focus states, forms, animation, typography, images, performance,
navigation/state, dark mode, touch interaction, and i18n.

Allowlists MANIFEST_MISSING_LICENSE because vercel-labs/agent-skills
declares MIT in README.md but does not include a LICENSE file at the
repository root, and this skill`s SKILL.md frontmatter does not embed an
SPDX license identifier.

Verified locally via `dockhand validate-skill` (Status: VALID, 1 file).
@samuv samuv self-assigned this Apr 30, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 30, 2026

🛡️ Skill Security Scan Results

✅ vercel-cli-with-tokens

  • Status: Passed
  • Findings: 5
  • Allowed (not blocking): 1
    • MANIFEST_MISSING_LICENSE (Allowed: vercel-labs/agent-skills declares MIT in README.md; upstream does not include a LICENSE file at the repository root, and this skill's SKILL.md frontmatter does not embed an SPDX license identifier.)

✅ vercel-composition-patterns

  • Status: Passed
  • Findings: 0

✅ vercel-react-best-practices

  • Status: Passed
  • Findings: 0

✅ vercel-react-native-skills

  • Status: Passed
  • Findings: 0

✅ vercel-react-view-transitions

  • Status: Passed
  • Findings: 2

Summary: Scanned 5 skill(s), all passed security checks. ✅

…ercel-labs set

CI`s skill-security-scan surfaced blocking findings on two of the seven
specs that are structural rather than allowlistable false positives:
- deploy-to-vercel: upstream ships an Archive.zip that contains
  executable scripts (deploy.sh, deploy-codex.sh) plus macOS
  resource-fork metadata (__MACOSX/._*.sh). Triggers
  HIDDEN_EXECUTABLE_SCRIPT (x2), ARCHIVE_CONTAINS_EXECUTABLE (x2), and
  LOW_ANALYZABILITY because 5/11 files are opaque to the scanner.
- web-design-guidelines: upstream SKILL.md delegates its rules to
  https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
  via WebFetch, with no version pin and no allowed-tools declaration.
  Triggers LLM_PROMPT_INJECTION (CRITICAL), LLM_SUPPLY_CHAIN_ATTACK,
  and LLM_UNAUTHORIZED_TOOL_USE.
Drop both rather than allowlist findings that flag genuine supply-chain
risk; revisit if upstream removes the bundled archive
(deploy-to-vercel) and pins the fetched URL with WebFetch scoped via
allowed-tools (web-design-guidelines).
@samuv samuv changed the title feat(skills): add 7 skills from vercel-labs/agent-skills feat(skills): add 5 skills from vercel-labs/agent-skills Apr 30, 2026
@samuv samuv merged commit 2557863 into main Apr 30, 2026
20 checks passed
@samuv samuv deleted the vercel-skills branch April 30, 2026 14:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants