Add eve-first build-agents skill (#138)

* Add eve-first build-agents skill

* Fix build-agents validation coverage

* Refine build-agents guidance

Author: darafsheh

CLAUDE.md

@@ -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
 
@@ -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
@@ -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
 ---

README.md

@@ -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
 
@@ -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                                                                                                                               |
 | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
@@ -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                                                      |
@@ -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                                                        |
@@ -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
@@ -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

generated/build-from-skills.manifest.json

@@ -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",

generated/skill-catalog.md

@@ -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
 
@@ -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 |
@@ -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:**
@@ -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`