vercel / vercel/vercel-plugin

runtime-cache skill: limits table says 64 tags per Runtime Cache item; Vercel's docs and observed behavior both say 128

Open Beginner friendly
#123 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
287
Forks
58
Avg merge
1d 1h
Merged PRs (30d)
17

Description

skills/runtime-cache/SKILL.md (line 251 on main) states:

Property Limit
Item size 2 MB
Tags per Runtime Cache item 64
Tags per CDN item 128
Max tag length 256 bytes

The Runtime Cache row appears to be wrong — the limit is 128, matching the CDN row.

Evidence

Vercel documentation. vercel.com/docs/runtime-cache § Limits and usage gives Tags per item | 128 tags. The same figure appears at vercel.com/docs/caching/runtime-cache. Both fetched 2026-07-19.

Observed behavior. Two 'use cache: remote' entries deployed on Vercel, differing only in tag count:

  • 121 tags — entry stored and served normally
  • 131 tags — write rejected, surfacing as Error: invalid response from cache for […]: 400

A cap of 64 would have rejected the 121-tag entry. The boundary sits between 121 and 131, consistent with 128 and inconsistent with 64.

Impact

The limit is enforced by rejecting the write, so an entry that exceeds it silently never stores while the render, the types, and every other check continue to look healthy. A threshold derived from 64 therefore misjudges the safe ceiling in the direction that hides the failure rather than surfacing it.

Because skills installed through npx skills are content-tracked in skills-lock.json, and both skills update and skills experimental_install overwrite local file changes without conflict, the figure can only be corrected here.

Suggested fix

Change the Runtime Cache row to 128. If the two rows are intended to capture a real distinction between the Runtime Cache and CDN layers, stating what that distinction is would help — as written the table implies the limits differ, while the runtime-cache documentation gives a single figure of 128 for tags per item.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open skills/runtime-cache/SKILL.md around line 251 and compare the Runtime Cache limits table with the linked Vercel documentation. Change the Runtime Cache tags-per-item value from 64 to 128, clarify the distinction between the Runtime Cache and CDN rows if needed, and verify the table matches the cited limits.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
90/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.