Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
6 changes: 3 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Source lives in `hooks/src/*.mts` (TypeScript) and compiles to `hooks/*.mjs` (ES

**Entry-point hooks** (wired in hooks.json):
- `session-start-seen-skills.mts` — initializes `VERCEL_PLUGIN_SEEN_SKILLS=""` in `CLAUDE_ENV_FILE`
- `session-start-profiler.mts` — activates only for greenfield directories or detected Vercel, Next.js, or Eve projects, then scans config files + package deps → sets `VERCEL_PLUGIN_LIKELY_SKILLS` (+5 priority boost)
- `session-start-profiler.mts` — activates only for greenfield directories or detected Vercel, Next.js, or eve projects, then scans config files + package deps → sets `VERCEL_PLUGIN_LIKELY_SKILLS` (+5 priority boost)
- `inject-claude-md.mts` — outputs the thin session-start Vercel context plus knowledge update guidance for that same activation set
- `session-end-cleanup.mts` — deletes session-scoped temp files

Expand All @@ -53,7 +53,7 @@ Source lives in `hooks/src/*.mts` (TypeScript) and compiles to `hooks/*.mjs` (ES

### Skill Injection Flow

1. **SessionStart**: For greenfield directories or detected Vercel, Next.js, or Eve projects, the profiler scans the project → sets `VERCEL_PLUGIN_LIKELY_SKILLS`
1. **SessionStart**: For greenfield directories or detected Vercel, Next.js, or eve projects, the profiler scans the project → sets `VERCEL_PLUGIN_LIKELY_SKILLS`
2. **PreToolUse** (on Read/Edit/Write/Bash): Match file paths (glob), bash commands (regex), imports (regex+flags) → apply vercel.json routing → apply profiler boost → rank by priority → dedup → inject up to 3 skills within 18KB budget
3. **UserPromptSubmit**: Score prompt text against `promptSignals` (phrases/allOf/anyOf/noneOf) → inject up to 2 skills within 8KB budget
- **3b. Lexical fallback** (when `VERCEL_PLUGIN_LEXICAL_PROMPT=on`): If phrase/allOf/anyOf scoring yields no matches above `minScore`, re-score using a lexical stemmer that normalizes prompt tokens before comparison — catches natural phrasing that exact-substring matching misses
Expand All @@ -66,7 +66,7 @@ Special triggers in PreToolUse:

### Skill Structure (`skills/<name>/SKILL.md`)

29 skills in `skills/`. Each has a `SKILL.md` with YAML frontmatter:
33 skills in `skills/`. Each has a `SKILL.md` with YAML frontmatter:

```yaml
---
Expand Down
13 changes: 7 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ This plugin gives AI agents a **relational knowledge graph** of the Vercel ecosy

## How Do I Use This?

After installing, the plugin keeps automatic behavior lightweight. Session-start activation now only kicks in for empty directories and detected Vercel, Next.js, or Eve projects, and Vercel skills are no longer auto-injected on every tool call or every prompt by default. The default post-tool path is now observer-only. The skills remain available for direct use, and the repo still keeps the injection engine for targeted or future opt-in workflows.
After installing, the plugin keeps automatic behavior lightweight. Session-start activation now only kicks in for empty directories and detected Vercel, Next.js, or eve projects, and Vercel skills are no longer auto-injected on every tool call or every prompt by default. The default post-tool path is now observer-only. The skills remain available for direct use, and the repo still keeps the injection engine for targeted or future opt-in workflows.

## Components

Expand All @@ -46,7 +46,7 @@ A text-form relational graph covering:
- Common cross-product workflows
- Migration awareness for sunset products

### Skills (32 skills)
### Skills (33 skills)

| Skill | Covers |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
Expand All @@ -55,6 +55,7 @@ A text-form relational graph covering:
| `ai-sdk` | AI SDK v6 — text/object generation, streaming, tool calling, agents, MCP, providers, embeddings |
| `auth` | Authentication integrations — Clerk, Descope, Auth0 setup for Next.js with Marketplace provisioning |
| `bootstrap` | Project bootstrapping orchestrator — linking, env provisioning, db setup, first-run commands |
| `build-agents` | Default eve-first agent builder — create AI agents, agent apps, tools, channels, schedules, and Slack agents |
| `cdn-caching` | Diagnose cache hit rate, stale content, revalidation behavior, per-request cache reasons, and ISR read/write cost across CDN/ISR/PPR |
| `chat-sdk` | Multi-platform chat bots — Slack, Telegram, Teams, Discord, Google Chat, GitHub, Linear |
| `deployments-cicd` | Deployment and CI/CD — deploy, promote, rollback, --prebuilt, CI workflow files |
Expand All @@ -74,7 +75,7 @@ A text-form relational graph covering:
| `turbopack` | Next.js bundler, HMR, configuration, Turbopack vs Webpack |
| `vercel-agent` | AI-powered code review, incident investigation, SDK installation, PR analysis |
| `vercel-cli` | All CLI commands — deploy, env, dev, domains, cache management, MCP integration, marketplace |
| `vercel-connect` | Managed OAuth tokens and third-party connections for apps, MCP servers, and Eve agents |
| `vercel-connect` | Managed OAuth tokens and third-party connections for apps, MCP servers, and eve agents |
| `vercel-firewall` | DDoS protection, WAF rules, rate limiting, bot filtering, and IP controls |
| `vercel-functions` | Serverless, Edge, Fluid Compute, streaming, Cron Jobs, configuration |
| `vercel-sandbox` | Ephemeral Firecracker microVMs for running untrusted/AI-generated code safely |
Expand Down Expand Up @@ -104,12 +105,12 @@ A text-form relational graph covering:

Lifecycle hooks that run automatically during your session:

- **Session start context injection** — Injects a thin Vercel session context plus the knowledge-update guidance for empty directories and detected Vercel, Next.js, or Eve projects
- **Session start context injection** — Injects a thin Vercel session context plus the knowledge-update guidance for empty directories and detected Vercel, Next.js, or eve projects
- **Session start repo profiler** — Scans config files and dependencies to set likely-skill hints, but only after that same activation check passes

## Usage

After installing, session context is injected automatically only for empty directories and detected Vercel, Next.js, or Eve projects. Vercel skills are available on demand, and you can invoke them directly via slash commands:
After installing, session context is injected automatically only for empty directories and detected Vercel, Next.js, or eve projects. Vercel skills are available on demand, and you can invoke them directly via slash commands:

```
/vercel-plugin:nextjs
Expand Down Expand Up @@ -228,7 +229,7 @@ Exits non-zero if any `SKILL.md` is stale. Add to CI to catch drift.
vercel-plugin/
├── .plugin/plugin.json # Plugin manifest
├── vercel.md # Ecosystem graph + conventions (injected via SessionStart hook)
├── skills/ # 32 skills
├── skills/ # 33 skills
│ ├── ai-sdk/ # Upstream-synced skill example:
│ │ ├── overlay.yaml # Plugin injection metadata
│ │ ├── upstream/ # Pure upstream content
Expand Down
2 changes: 1 addition & 1 deletion generated/build-from-skills.manifest.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"version": 1,
"generatedAt": "2026-07-24T23:01:09.007Z",
"generatedAt": "2026-08-12T03:07:25.183Z",
"templates": [
{
"template": "agents/ai-architect.md.tmpl",
Expand Down
14 changes: 11 additions & 3 deletions generated/skill-catalog.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Skill Catalog

> Auto-generated by `scripts/generate-catalog.ts` — do not edit manually.
> Generated: 2026-08-06T02:59:07.756Z
> Skills: 32
> Generated: 2026-08-11T14:42:04.764Z
> Skills: 33

## Table of Contents

Expand All @@ -15,6 +15,7 @@

| Skill | Priority | Path Patterns | Bash Patterns | Import Patterns |
|-------|----------|---------------|---------------|-----------------|
| `build-agents` | 10 | 0 | 3 | 0 |
| `knowledge-update` | 10 | 1 | 0 | 0 |
| `workflow` | 9 | 6 | 14 | 4 |
| `access-protected-vercel-deployment` | 8 | 0 | 4 | 0 |
Expand Down Expand Up @@ -50,6 +51,13 @@

### Skill Details

#### `build-agents` (priority 10)

**Bash patterns:**
- `\bnpx\s+eve(?:@latest)?\s+init\b`
- `\bbunx\s+eve(?:@latest)?\s+init\b`
- `\beve\s+init\b`

#### `knowledge-update` (priority 10)

**Path patterns:**
Expand Down Expand Up @@ -978,7 +986,7 @@ Shows which skills compete on shared bash commands.

## Skills by Priority

**Priority 10:** `knowledge-update`
**Priority 10:** `build-agents`, `knowledge-update`

**Priority 9:** `workflow`

Expand Down
Loading
Loading