Skip to content

feat: add microfrontends skill#97

Merged
tim123abc merged 4 commits into
mainfrom
tim123abc/microfrontends-skill
Jun 9, 2026
Merged

feat: add microfrontends skill#97
tim123abc merged 4 commits into
mainfrom
tim123abc/microfrontends-skill

Conversation

@tim123abc

@tim123abc tim123abc commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Adds the microfrontends skill for building, configuring, and deploying microfrontends on Vercel.

Contents

  • skills/microfrontends/SKILL.md + 6 reference docs (configuration, path-routing, local-development, managing, security, troubleshooting)
  • Regenerated generated/skill-manifest.json and generated/skill-catalog.md (27 skills)
  • Updated vercel.md ecosystem graph

Triggering

  • pathPatterns: microfrontends.json, apps/*/microfrontends.json
  • bashPatterns: vercel microfrontends / vercel mf, and npm/pnpm/bun/yarn install of @vercel/microfrontends
  • importPatterns: @vercel/microfrontends

Note

This rebases the work from #35 onto current main as a single signed commit, to satisfy the repository's "commits must have verified signatures" rule (the original branch carried main's pre-rule unsigned history, which the rule re-flagged). Supersedes #35.

🤖 Generated with Claude Code


Design rationale (re: triggering & references)

How does the skill get triggered? (and is it over-eager?)

Deliberately conservative on the automatic (hook) side:

  • No promptSignals → never injected by exact prompt phrase-matching.
  • Hook injection fires only on concrete signals you'd hit when you mean it:
    • editing microfrontends.json / apps/*/microfrontends.json (pathPatterns)
    • running vercel microfrontends / vercel mf (bashPatterns)
    • installing or importing @vercel/microfrontends (bashPatterns + importPatterns) — added in this PR
  • The only fuzzy prompt path is the lexical fallback scored against the retrieval block (aliases/intents/entities), gated by a min-score threshold, a hard floor, dominant-topic suppression, and a 2-skills / 8KB cap.

So it won't trigger constantly. Note this PR intentionally broadens triggering vs. the original by adding import/install matching (the most common real entry points, matching every other package-centric skill, e.g. vercel-sandbox, vercel-storage, ai-sdk) — still precise signals, not loose ones. The softest surface is the long description text (what Claude reads to self-invoke); that's the lever to trim if it ever feels over-eager.

Why a references/ directory instead of one flat file?

  • SKILL.md is a 32-line router: core concepts + CLI surface + a topic→file table with an explicit "do not read all references upfront — grep the relevant one."
  • The 6 reference docs total ~1,058 lines (trimmed from ~1,122 — see the boilerplate-trim commit).
  • A flat ~1,150-line skill would blow the 8KB UserPromptSubmit budget and crowd the 18KB PreToolUse budget, getting truncated to its summary. Progressive disclosure keeps the always-injected payload tiny and pulls depth on demand.
  • A flat file is only preferable when a skill fits budget (~150–200 lines) with no natural topic split. This skill is well past that, so the split matches the nextjs / vercel-cli pattern.

Adds the `microfrontends` skill (SKILL.md + 6 reference docs covering
configuration, path-routing, local development, management, security,
and troubleshooting) for building, configuring, and deploying
microfrontends on Vercel.

Triggering covers the common entry points:
- pathPatterns: microfrontends.json / apps/*/microfrontends.json
- bashPatterns: `vercel microfrontends` / `vercel mf`, and
  npm/pnpm/bun/yarn install of @vercel/microfrontends
- importPatterns: @vercel/microfrontends

Regenerates generated/skill-manifest.json and generated/skill-catalog.md
(now 27 skills) and updates the vercel.md ecosystem graph.

Rebased onto current main as a single signed commit (supersedes #35).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@tim123abc tim123abc mentioned this pull request Jun 4, 2026
3 tasks
Lowest-risk size reduction with no loss of factual content:
- Remove Table-of-Contents blocks from local-development, managing-
  microfrontends, and troubleshooting references. No other skill's
  reference files use a ToC (0 of 51 repo-wide) — these were the only
  outliers; removal aligns with house convention. Section anchors are
  unaffected, so in-doc links still resolve.
- Tighten security.md: dedupe repeated "verified only by…" prose and
  collapse repeated full URLs. All 13 original links preserved.

Net: -64 lines across 4 reference files. References are loaded on demand
(grep), not part of the injected SKILL.md budget, so this is a read-cost
and maintainability win, not an injection-size change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@tim123abc tim123abc requested a review from Melkeydev June 4, 2026 14:28
@Melkeydev

Copy link
Copy Markdown
Collaborator

approved - just bump the versions for all the providers please

tim123abc and others added 2 commits June 9, 2026 08:10
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@tim123abc tim123abc merged commit b73bc95 into main Jun 9, 2026
3 checks passed
jpsingaraju added a commit that referenced this pull request Jun 9, 2026
Merges the microfrontends skill (#97) from main and regenerates the
shared registry artifacts so both skills coexist.

Conflicts resolved:
- generated/skill-manifest.json — regenerated via `bun run build:manifest`
  (28 skills total, includes both vercel-connect and microfrontends)
- generated/skill-catalog.md — regenerated via `bun run scripts/generate-catalog.ts`
- vercel.md — auto-merged cleanly; both skill graph nodes preserved

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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