Challenges live at a few key entry points. The public listing at /challenges is where you browse and filter published challenges before you commit to one. Each challenge has a detail surface at /challenges/[slug] that combines the overview, tools, datasets, rubric, gold items, and leaderboard context. Creators work from /challenges/create using guided creation, manual creation, or studio-backed editing. The best pairing for serious work is the CLI plus the browser: seed repo context locally, then use the detail page for run-specific evaluation.
A challenge is not just a prompt. It is a task plus evidence. Strong challenge pages combine the brief, tools, datasets, gold items, rubric, and the leaderboard into one operator surface. That is what makes the route useful for both individual practice and serious comparison. Browse public challenges.
Find the right challenge
Use the listing surface to narrow the field before you open a detail page. Good filtering matters because challenge quality is not only about topic; it is also about whether the evaluation method and tools match the kind of work you actually want to do.
Filter by difficulty and scope
Use difficulty, category, and search to find work that is challenging enough to be useful but not so broad that it becomes noise. Open challenge filters.
Check tools and datasets early
Do not start a challenge until the required tools, datasets, and evaluation style match the workflow you actually want to practice. Inspect tool ecosystem.
Decide browser-first versus repo-first
Some challenges are best explored from the detail page, while others benefit from seeding local repo context through the CLI first. Read CLI workflow.
What a challenge detail page includes
The detail surface is where you decide whether the task is worth the time. It should tell you what success looks like, what tools or data are in play, and how your output will be judged before you start building.
Brief and task framing
The challenge overview explains the task, expected output, and why the work is non-trivial.
Rubric and gold items
Evaluation dimensions and reference items give you an evidence model instead of forcing you to guess what “good” means.
Tools, datasets, and supporting material
Use the tabbed surfaces to understand what technologies or source material the challenge assumes.
Leaderboard and peer context
The leaderboard is not just a scoreboard. It tells you what good performance or completion looks like in the wild.
Take a challenge
A clean challenge workflow stays sequential: understand the task, seed your context if needed, build deliberately, then submit with enough implementation detail that the result is interpretable later.
- Open the detail page and read the task end to end. Do not skip the rubric, tools, or gold items if they exist. Those define the real work. Start from challenge list.
- Seed local context when the task deserves repo work. Use the CLI when you want the challenge brief and metadata in your project before you start coding or prompting. Open CLI docs.
- Build one clear iteration first. Treat the first run as the source baseline. Improve after you have one coherent attempt, not before.
- Submit with enough metadata to be useful later. The goal is a run record you can compare, explain, and learn from, not just a one-off upload.
Create or edit challenges
Versalist supports multiple creation surfaces because not every creator works the same way. Use the simpler route when you want to get to a draft quickly, and studio-backed editing when the challenge needs more structure or follow-up refinement.
Create challenge
Use the standard creation routes for guided or manual challenge setup from the challenges module. Open /challenges/create.
Studio workflows
Use studio when you want a denser creation and editing environment with stronger creator-oriented structure. Open studio.
Generate the first draft with AI
The AI-assisted creation routes are useful when you want a structured first pass and plan to refine the draft after. Open AI-assisted creation.
Fix tools and supporting metadata
Use the specialized maintenance surfaces when the problem is stale tool data or challenge support content rather than the core prompt itself. Open fix-tools.
How evaluation works
Challenge evaluation is strongest when it combines explicit dimensions with reference material. The important principle is that the page should make it obvious what evidence counts, not rely on “you will know it when you see it.”
Rubric dimensions
Weighted dimensions help you understand what matters before you start iterating.
Gold items and examples
Reference items anchor the evaluation and make the task easier to interpret across different runs.
Leaderboard feedback
Leaderboard context shows what strong performance or completion looks like against other participants.
What strong participants do
Strong challenge users do not only optimize for submission count. They pick a challenge with the right scope, keep one clean baseline, and use the evaluation surfaces to explain why a later run is better than the first one.
- Read before acting. Use the task, rubric, and gold-item surfaces before you start building.
- Keep a clear baseline. Your first coherent attempt is the reference point for every later iteration.
- Improve one dimension at a time. Do not rewrite the entire approach at once if you want the leaderboard feedback to mean anything.
- Use the challenge as a learning record. Treat runs, prompts, and related artifacts as reusable work, not disposable one-offs.