Submit a skill
BENCH ENGINE · IDLENEXT CYCLE · —:—:—NEXT · —:—
FAQ

Frequently asked.

Everything we get asked, by category. If your question isn't here, email contact@flukxstudio.fr.

General

What is Versuz exactly ?
A public benchmark and marketplace for AI agent skills. We index every public SKILL.md and CLAUDE.md from GitHub, run them through a held-out task suite, judge the outputs with three frontier LLMs, and publish a ranking. Free directory by default, with optional premium opt-in for authors.
Who is Versuz for ?
Developers who use Claude Code, Codex CLI, Cursor, or any agentic coding tool, and who want to know which SKILL.md actually performs vs. just being popular. Also for authors who want their work surfaced fairly, and discovered.
Is Versuz affiliated with Anthropic ?
No. We index skills from Anthropic's official repos and many others, but Versuz is an independent third-party project. The name and brand are unrelated to Anthropic.
What's the business model ?
Three tiers : free directory (the bulk), premium items at author-set prices (Versuz takes 30%), and Versuz-curated "featured" items (100% Versuz). Plus a flat "Boost" placement fee ($4.99 / 30 days, max 365 days). See /pricing for details.

Ranking & bench

How are skills ranked ?
Each skill in a category runs through the same 30-task suite (a held-out evaluation set we maintain). An agent LLM executes each task using the skill. Then 3 judge LLMs (Claude Haiku 4.5, DeepSeek V4 Flash, GPT-5 mini, configurable) independently grade each output on 5 axes : instruction-following, correctness, completeness, usefulness, safety. Weighted composite gives the final score. Full methodology at /methodology.
Why three judges ?
Single-judge ranking is biased toward whatever model is judging. Three frontier models from different labs (Anthropic, DeepSeek, OpenAI) reduce the bias and let us measure disagreement explicitly. Disagreement is published — if judges disagree on a skill, we flag it.
What if my skill is brand new and not yet judged ?
It shows up immediately on /marketplace with a quality_score (from a cheap LLM cold-start rate over the same 5 axes). It enters the next bench cycle for its category. Bench cycles run daily on rotation.
Are bench scores reliable ?
They're indicative, not authoritative. LLM-as-judge is a noisy method. We mitigate with 3 judges, 5 tasks per item (N=5), anti-inflation rubric, and weighted composite. CI95 ~±6-7 points typically. We're also planning a human calibration set (200 hand-judged items) to learn an affine transform per judge.
Can I see how a specific skill scored on each judge ?
Yes. Click any ranked skill to see per-axis breakdown, per-judge averages, judge disagreement label (high / mid / low), and sample rationales. We publish disagreement rather than hide it.

Submitting & claiming

How do I submit my SKILL.md or CLAUDE.md ?
Three ways : via the web form on /submit (paste a GitHub URL), via the CLI npx versuz submit https://github.com/your/repo, or just publish it on GitHub and wait — we'll find it via our daily scrape.
Does Versuz scrape my repo without permission ?
We only index publicly readable repos via the GitHub search API, under fair use for indexing and benchmarking. We respect robots.txt, preserve the original GitHub link, capture the SPDX license, and act on takedown requests within 7 days. To request removal, email contact@flukxstudio.fr or follow the DMCA process.
How do I claim ownership of a scraped item ?
Visit /claim, sign in with the GitHub account that owns the repo, and click "Claim". We re-verify ownership against the GitHub API on each claim. Auto-claim happens on submit if you use the CLI.
What happens if someone claims my skill wrongly ?
False ownership claims are grounds for account termination. The claim only succeeds if your GitHub account matches the repo owner or is a verified member of the org. If you see something wrong, email contact@flukxstudio.fr with proof and we'll fix it within 24h.

Premium & payments

Do I have to pay anything to use Versuz ?
No. The directory is free, the rankings are free, the CLI and MCP server are free. You only pay if you buy a premium item from another author — and even then, you can browse without buying.
How does the 30/70 split work ?
Authors of premium items receive 70% of every sale, deposited automatically to their Stripe Connect account. Versuz keeps 30% as platform fee, processed via Stripe destination charges (no manual payouts needed). Sellers see their earnings in real-time on /profile/earnings.
Can I refund a premium purchase ?
Yes — 30 days no-questions-asked. Email contact@flukxstudio.fr with your Stripe Payment Intent ID and we refund within 24h (Stripe processes the credit in 5-10 business days). See Refund Policy.
What does "Boost" do exactly ?
Boosting an item costs $4.99 / 30 days flat. It pins the item at the top of the marketplace (6 slots maximum visible) and adds a discreet amber ribbon. It does NOT change the ranking or bench score — it's pure discovery placement. Stackable up to 365 days max. Versuz takes 100% (no Connect split for boost, it's pure ad placement).
How do I activate selling on Versuz ?
Go to /profile/settings → "Become a seller →". This launches a Stripe Express onboarding (pre-filled France by default). Stripe takes a few minutes to verify ID/IBAN. Once charges_enabled, you can list premium items via the Submit form with a tier picker.

Data & privacy

What personal data does Versuz collect ?
Minimal : GitHub username + email (via Supabase Auth OAuth), purchase records (Stripe Payment Intent IDs), and CLI submission audit logs (anti-spam). No third-party analytics, no marketing cookies, no tracking. Full details at /legal/privacy.
Where is my data hosted ?
Database in Supabase (EU region, Frankfurt). Payment processing via Stripe (EU + US with EU data processing addendum). Hosting via Vercel (US-based, EU edge). All transfers covered by EU-US Data Privacy Framework + Standard Contractual Clauses.
Can I export or delete my data ?
Yes. Email contact@flukxstudio.fr for GDPR data export (JSON, within 30 days) or account deletion (within 30 days, except where retention is legally required like 10-year accounting for purchases).
Does Versuz use the data of indexed skills to train models ?
No. We use indexed SKILL.md and CLAUDE.md only for the public benchmark (running them through tasks) and for the marketplace surface. We do not train any model on user-submitted or scraped content.

Tech & integrations

What stack does Versuz use ?
Next.js 16 App Router on Vercel, PostgreSQL 17 via Supabase, Stripe Connect Express for payments, Resend for transactional emails, OpenRouter for the bench (Anthropic + DeepSeek + OpenAI). Code published as MIT on GitHub.
Is there an API ?
Yes, v1 JSON API at /api/v1/skills + /api/v1/claude-md + content/installation endpoints. Documented at /about. The CLI and MCP server both consume this API.
How do I use the MCP server with Claude Code ?
claude mcp add versuz npx -y @versuz/mcp. Claude Code can then search, list, get, and install skills inline. 5 tools exposed. See /about.
Can I run the bench locally on my own skills ?
The bench code is in /scripts/bench/ on GitHub (MIT). You can clone, set BENCH_MODE=dev for free Groq judges, and run npm run bench against your own tasks + subjects. Bring your own LLM keys and Supabase project.

Contact

How do I reach you ?
General : contact@flukxstudio.fr. Support / refunds : contact@flukxstudio.fr. Bugs : GitHub issues ↗.
Versuz is open source ?
The code is MIT-licensed on github.com/TomaTV/versuz ↗. You can self-host if you want your own private Versuz, though scaling the bench economics is hard solo.
Is there a Discord / Slack ?
Not yet. We may open one if there's demand. Easiest is to email or open a GitHub issue for now.
Still stuck ?

Email contact@flukxstudio.fr and we'll get back within 48h.