docs(marketplace): simplify skill, emphasize discovery-first workflow#99
Open
jpsingaraju wants to merge 3 commits into
Open
docs(marketplace): simplify skill, emphasize discovery-first workflow#99jpsingaraju wants to merge 3 commits into
jpsingaraju wants to merge 3 commits into
Conversation
Trim marketplace SKILL.md from 491 lines to 212. Remove partner-facing content (building integrations, Observability deep-dive, per-integration code samples) and the hardcoded category list — those duplicate the live \`vercel integration categories\` output and go stale. Lead with a prominent "Discover BEFORE you scaffold" section so agents treat \`vercel integration discover\` as the first action on casual "build me X" prompts rather than scaffolding from memory. Document the multi-\`--category\` flag pattern alongside the new \`vercel integration categories\` subcommand. Regenerate skill-manifest.json (intents updated: drop "build integration", add "discover integrations").
The marketplace command template pulled the entire "Observability Integration Path" section from the marketplace skill, which was 50+ lines of vendor data-type tables and a 4-step setup flow — most of which the template's Step 7 didn't need. The simplified marketplace skill (this PR) removed that section, breaking the include resolver. Inline only what Step 7 actually uses: the drain verification curl command and the logs/traces vs Speed-Insights/Web-Analytics distinction. Regenerate commands/marketplace.md and build-from-skills manifest.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Trim
skills/marketplace/SKILL.mdfrom 491 → 212 lines (-57%) and reframe around the discovery-first workflow.Removed:
vercel integration categoriesoutput and goes stale)Added / restructured:
vercel integration discoveras their first action, not write app code from memory--categoryflag pattern documented (e.g.,discover --category commerce --category payments --category auth)vercel integration categoriessubcommand integrated into the taught workflowRegenerated:
generated/skill-manifest.json(intents updated: drop "build integration", add "discover integrations")Why
When measured against realistic user prompts ("build me an Etsy clone", "I want a habit tracker") the agent skipped Marketplace discovery entirely and scaffolded from training-data memory — recommending libraries that may not be on the Marketplace and missing auto-provisioned env vars + unified billing. The new framing makes discovery the load-bearing first step.
Companion PR
CLI changes that this skill teaches (
vercel integration categoriessubcommand, repeatable--categoryflag): vercel/vercel#16593 (will need an upstream sync intoskills/vercel-cli/upstream/after that merges).Test plan
generated/skill-manifest.jsonregeneration is correct