Vaybel Skills
Vaybel Skills are agent workflows for operating clothing-product workflows through the public Vaybel MCP server.
Documentation: https://vaybel.github.io/skills/
This repo follows the code-execution-with-MCP pattern:
Agent skill -> TypeScript orchestration -> mcp.vaybel.com
There is no CLI dependency in v1. Skills call MCP through the small wrappers in
servers/vaybel/, authenticated by VAYBEL_PAT.
These skills are the advanced user's starting point: fork them and iterate on the orchestration to fit your own workflow. The public MCP and REST surface is deliberately made of primitives; workflows are yours to compose, fork, and tweak here.
Skills
/vaybel:find-trend- find a trend opportunity and generate a launch concept./vaybel:plan-drop- plan a themed release: create or open a drop, see which trends fit its brief, pin them, file designs into it, and read its readiness./vaybel:launch-product- select a blank, generate a design, generate listing-ready mockups, optionally generate listing product videos, and return concise launch links./vaybel:optimize-product- import and optimize an existing Printify or Printful product./vaybel:make-content- generate a video, slideshow, carousel, or single post for an existing listing, with social drafts and explicit publish./vaybel:analyze-insights- read performance KPIs, top design snapshots, credit state, and next-best-action guidance.
The scope matches the four primary Vaybel workflows:
Find Trend -> Launch Product -> Optimize Product -> Make Content
plan-drop wraps that loop in a release: a drop pins the trends that fit its
brief and tracks the designs launched from them until they are live.
analyze-insights is a read-only management skill for deciding which workflow to
run next.
Setup - Recommended
Claude Code marketplace install:
/plugin marketplace add vaybel/skills
/plugin install vaybel@vaybel
Use one shared secret for MCP and skills: define VAYBEL_PAT in Claude Code
settings, and reference it from the Vaybel MCP server config. Then run:
/vaybel:launch-product "washed trail running poster art on a heavyweight tee"
/vaybel:launch-product "washed trail running poster art on a heavyweight tee" --listing-channels tiktok_shop,etsy
/vaybel:find-trend tshirt --lifecycle rising
/vaybel:plan-drop "Fall '26" --kind seasonal --date 2026-10-01 --motifs pumpkin,moon
/vaybel:optimize-product --provider printify --product-id <external-id>
/vaybel:make-content <listing-id> --channels tiktok,instagram
/vaybel:analyze-insights --range 28d
Manual Setup
git clone https://github.com/vaybel/skills.git
cd skills
npm install
export VAYBEL_PAT="<your-vaybel-pat>"
./setup
Repository Layout
client.ts MCP transport and auth helper
servers/vaybel/ thin typed wrappers around public MCP tools
skills/*/ SKILL.md plus TypeScript orchestration per workflow
.claude-plugin/ Claude Code marketplace metadata
.codex-plugin/ Codex plugin metadata
.cursor-plugin/ Cursor plugin metadata
docs-site/ Astro Starlight documentation site (GitHub Pages)
scripts/validate.mjs structural validation for skills and manifests
scripts/smoke/ clean-project host install smoke tests
DEPLOYMENT.md marketplace deployment checklist
Validate
npm run validate
npm run typecheck
npm run build
npm audit --omit=dev --audit-level=moderate
scripts/smoke/host_install_smoke.sh
The smoke script creates a clean sibling project, installs the plugin into
isolated Claude and Codex homes when those CLIs are available, and runs every
skill runner in no-token mode. It uses tmux automatically when installed;
pass --no-tmux to run serially.
Docs Site
The published docs at https://vaybel.github.io/skills/ are generated from this
repository, not maintained separately. docs-site/scripts/sync-docs.mjs rebuilds
every page from skills/*/SKILL.md, the skill references/, and the root
Markdown files, so the site cannot drift from the skills it documents.
npm run docs:dev # local dev server
npm run docs:build # production build into docs-site/dist
.github/workflows/pages.yml builds the site on every pull request and deploys
it to GitHub Pages on push to main.