Skip to content

SkillFoundry Documentation

Welcome to the SkillFoundry documentation. SkillFoundry is a technical skills assessment platform built around real-world engineering work — instead of algorithm puzzles, candidates work on tasks derived from actual pull requests, complete with repositories, tests, documentation, and AI-simulated stakeholders.

Use the guides below to get started, learn each feature, integrate with the API, and resolve common issues.

Getting started

Guide Who it's for
Platform overview Everyone — what SkillFoundry is, roles, and core concepts
Getting started for candidates Developers taking assessments or practicing
Getting started for hiring teams Interviewers and recruiters
Getting started for organization admins Admins setting up an organization

Desktop apps

Guide Covers
macOS app Product surface, privacy guarantees, MDM keys, and employee set-and-forget agent
Windows app .NET/Avalonia desktop agent — same surface as macOS for Windows fleets

Feature guides

Guide Covers
Taking an assessment in the browser The web code workspace: editor, tests, AI customer chat, submitting
Taking an assessment in VS Code Installing the extension, session tokens, cloning, submitting
Creating and managing tasks Importing PRs, templates, the Task Builder, task visibility
Reviewing candidates Evaluation queue, score reports, behavioral insights, AI-usage flags
Learning paths and gamification Learning paths, sprints, XP, achievements, streaks, leaderboards
Organization administration Members, invitations, org settings, SSO/SCIM, branding
Billing and subscriptions Plans, checkout, invoices, plan limits, upgrades

Privacy and integrity

Guide Covers
Monitoring and data collection Exactly what SkillFoundry collects during assessments, and what it never collects
Behavioral monitoring privacy model Legal bases, data minimization, EU works-council posture, and DPIA summary for behavioral monitoring

Trust and compliance

For Legal, Security, and Procurement — the compliance story for a tool that handles candidate data and helps drive employment decisions.

Guide Covers
Trust and compliance overview Controller/processor roles, the shared-responsibility model, regulation-to-control map, and how to request documents
Access and audit logging Who viewed/changed/exported what, retention, integrity, and current coverage vs. gaps
Data retention and erasure GDPR/CCPA data-subject rights, retention schedule, erasure mechanics, consent, breach notice
Bias audits and adverse impact NYC Local Law 144, EEOC four-fifths rule, what the behavioral score measures, and what data an audit needs
Certifications and attestations SOC 2 / ISO 27001 posture, implemented security controls, sub-processors
Data Processing Addendum DPA structure, data categories, SCCs/international transfers, TOMs
Candidate rights and appeals Candidate transparency, human review, appeal workflow, and accommodations

API documentation

Guide Covers
API overview Base URL, authentication, errors, rate limits, pagination, versioning
API reference Endpoint reference grouped by domain
Integration guide End-to-end walkthrough: create a task, run an assessment, retrieve scores

Help

Guide Covers
Frequently asked questions Quick answers to the most common questions
Troubleshooting Symptom → cause → fix for common problems

If you can't find an answer here, contact support from the Support page in the app (/support) or through your organization's account contact.