# Versalist Documentation

> Comprehensive platform for AI skill development, challenge-based learning, and portfolio building.

## Overview

Versalist helps students and working professionals develop job-ready AI skills through:
- A full agent training loop for challenge design, rollout traces, reward signals, and skill iteration
- Challenge-based learning with real-world AI engineering challenges
- A comprehensive AI tools directory with 100+ tools, frameworks, and agents
- Structured skill paths and certifications
- Prompt library with 200+ curated prompts
- Evaluations directory with 50+ assessment harnesses
- Portfolio building with verified skill badges and certificates
- Real-time AI engineering signal feed (Pulse)

## Quick Links

- Challenges: /challenges
- AI Tools Directory: /ai-tools
- Prompt Library: /prompt-library
- Evaluations: /evaluations
- Skill Bundles: /skill-bundles
- Learning Tracks: /skills
- Pulse Feed: /pulse
- Blog: /blog
- Guides: /guides
- Pricing: /pricing
- FAQ: /faq
- Changelog: /changelog
- Documentation: /docs
- Agent Training Stack: /docs/agent-training-stack
- Integrations: /docs/integrations
- API Keys: /docs/api-keys
- CLI: /docs/cli

## Documentation Pages

Use these pages when an agent needs product architecture, integration boundaries, or implementation guidance:
- /docs/agent-training-stack - Explains the Versalist training loop: challenge, rollout, judge, reward, and skill update. In Versalist, training means skill iteration against reward signals, not model-weight updates.
- /docs/integrations - Explains BYOK inference, provider-key storage, and the distinction between live integrations and RFC-stage provider depth.
- /docs/challenges - Challenge creation, public challenge pages, submission flow, and challenge APIs.
- /docs/skills - Skill bundles, reusable skills, and how skills connect to challenge evidence.
- /docs/api - Public API overview.
- /docs/api-keys - Platform API keys for authenticating against Versalist APIs.
- /docs/cli - CLI usage for pulling challenge briefs and metadata into local projects.
- /docs/glossary - Shared terminology for the product and docs.

## Getting Started

### Create Your Account
Visit versalist.com and sign up using:
- Email authentication
- Google OAuth
- GitHub OAuth

### Complete Your Profile
1. Add your professional information and current role
2. Select your areas of interest in AI
3. Set your learning goals and experience level

### Free vs Premium

**Free Tier:**
- Access to public challenges
- Browse AI tools directory
- Community participation
- Basic skill assessments

**Premium Tier:**
- Unlimited access to all challenges
- Full AI tool integrations
- Advanced skill assessments and personalized learning paths
- Portfolio builder with verification
- Premium learning resources
- Priority support

## Challenges

The Challenge Hub is the primary entry point for AI skill-building and competition.

### Challenge Directory
- URL: /challenges
- Filter by: difficulty, category, tags, search
- Sort by: newest, trending, popular
- Pagination with configurable page size

### Challenge Detail Pages
Each challenge at /challenges/{slug} has six tabs:
- Overview: Description, objectives, requirements, resources, technical requirements, rules
- AI Tools: Recommended tools with primary/secondary layers, tool suggestions
- Prompts: Dynamic challenge prompts and tasks
- Evaluation: Evaluation modules with pass/fail tests, metrics, sample inputs/outputs
- Run: Challenge execution environment
- Leaderboard: Multi-dimensional scoring, participant rankings

Additional detail page features:
- Difficulty level (beginner, intermediate, advanced, expert)
- Category and tags
- Skill badges (environment-building, reward-engineering, etc.)
- Datasets with downloadable resources and schema definitions
- Related challenges
- Suggested tool stacks with usage counts
- Markdown export for offline use
- GitHub integration (link or create repositories)
- Progress tracking with completion percentage
- View count and participant count
- Timeline (start, close, registration dates)
- Status labels (active, closed, evergreen)

### Submissions
Participants can submit solutions including:
- Project URL (demo/live link)
- YouTube video demonstration
- GitHub source code repository
- Dataset links
- Community upvote/downvote system
- Team submissions with team name support

### Challenge Creation
- Challenge Studio at /studio for creating and publishing challenges
- AI-assisted creation mode with auto-generated content
- Manual creation with full control
- Evaluation module auto-generation at publication
- Datasets management with upload, schema definition, and file tracking
- Tool configuration with validation checks
- Skills/domains linking

### Challenge Resources
- Challenge guide: /challenges/guide
- Random challenge discovery ("Surprise Me")

### Public Challenge API Endpoints
- GET /api/challenges/public - List public challenges
- GET /api/challenges/active - Active challenges
- GET /api/challenges/meta - Challenge metadata for filters
- GET /api/challenges/random - Random challenge
- GET /api/challenges/{id}/datasets - Datasets for a challenge
- GET /api/challenges/{id}/submissions - Submissions
- GET /api/challenges/{id}/leaderboard - Leaderboard rankings
- GET /api/challenges/{id}/tools - Tools for a challenge
- GET /api/challenges/{id}/tool-suggestions - AI tool suggestions
- GET /api/challenges/{id}/skills - Linked skills
- GET /api/challenges/{slug}/markdown - Markdown export
- POST /api/challenges/{id}/view - Record view count
- GET /api/challenges/related/{id} - Related challenges

## AI Tools Directory

A comprehensive directory of AI tools, frameworks, agents, and model providers.

### Directory Pages
- Browse all tools: /ai-tools
- Tool detail: /ai-tools/{slug}

### Search & Filtering
- Full-text search across names, descriptions, and companies
- Filter by category, license type, hosting, integrations, and language
- Tabs: All Tools, Featured, Trending
- Curated collections: Staff Picks, Trending, Beginner-friendly

### Category Clusters
- Model Providers
- Code Assistants
- Frameworks & SDKs
- Agents & Automation
- Vector Databases & Memory
- IDE Plugins & Extensions
- Infrastructure & Hosting
- Evaluation & Ops

### Tool Detail Pages
Each tool page at /ai-tools/{slug} includes:
- Description, company, pricing, and license info
- Capabilities and features list
- Integrations and platform compatibility
- GitHub statistics (stars, forks, contributors)
- User ratings and reviews
- Similar tools recommendations
- Challenge suitability by workflow stage (coding, testing, prompt generation, evaluation)
- Related challenges
- Learning resources (tutorials, videos, courses)
- Community-curated prompts for the tool
- Code examples and community projects
- Documentation links

### Public AI Tools API Endpoints
- GET /api/ai-tools - Search and filter tools
- GET /api/ai-tools/index - Semantic search with relevance ranking
- GET /api/ai-tools/categories - Category hierarchy with counts
- GET /api/ai-tools/featured - Featured tools
- GET /api/ai-tools/curated?collection={name} - Curated collections
- GET /api/ai-tools/{slug} - Tool details
- GET /api/ai-tools/{slug}/similar - Similar tools
- GET /api/ai-tools/{slug}/challenges - Related challenges
- GET /api/ai-tools/{slug}/prompts - Prompts for the tool
- GET /api/ai-tools/{slug}/learn - Learning resources

## Prompt Library

Browse, save, and organize 200+ battle-tested AI prompts.
- URL: /prompt-library
- Public prompts feed: /prompts
- Filter by challenge, category, and tool
- Community curation and submissions

### Public Prompt API Endpoints
- GET /api/prompts/public - Public prompts feed
- GET /api/prompt-library/public-challenges - Challenges with prompts

## Evaluations

Directory of 50+ evaluation harnesses for assessing AI capabilities.
- URL: /evaluations
- Types: task-based, benchmark-aligned
- Search and filter by type
- Linked to challenges and AI tools

### Public Evaluations API
- GET /api/evaluations/public - Browse evaluations

## Skills

Versalist exposes two public skill surfaces:
- Skill bundles: /skill-bundles
- Learning tracks: /skills

Supporting skill route:
- Guided skill path: /skill-path

## Pulse

Real-time AI engineering signal feed.
- URL: /pulse
- Configs, tools, and micro-challenges
- Trend data and community engagement

### Public Pulse API
- GET /api/pulse - Pulse feed

## Community

- Community hub: /community
- Leaderboards: /community/leaderboard
- Community challenges: /community/challenges
- Certificates: /certificates/public/{id}
- Weekly progress reports

## Additional Features

- Interview Practice: AI-powered practice sessions at /interview
- AI Readiness Assessment: /ai-readiness-assessment
- Projects: Track AI learning journey at /my-projects
- Progress Dashboard: /progress/dashboard
- Blog: /blog
- Guides: /guides
- Partnership: /partnership

## Support

- FAQ: /faq
- Email: support@versalist.com
- Feedback: /feedback

---
Generated from Versalist Documentation
https://versalist.com