Contents

Lucuma User Guide

Everything you need to screen CVs accurately and efficiently. This guide walks through every feature from first screening to sharing results with clients.

Getting started

1

Set your criteria

Start on the Criteria tab. This is where you define what you're looking for, your boolean query, required keywords, location, nationality, industries and minimum years of experience.

2

Upload your job spec (optional but recommended)

Go to the Job Spec tab and upload a PDF of the job description. This allows Lucuma to calculate how many of each candidate's years are relevant to this specific role, not just their overall career.

3

Upload CVs and run

Go to the CVs tab, drag in your CV files, then click Run Screening. Results appear in real time as each CV is processed.

Boolean search

Lucuma's boolean search is semantic, it understands what you mean, not just the exact words on the CV.

Use the operator buttons (AND, OR, NOT) to build your query, or type it directly:

  • drilling AND offshore, candidate must have both
  • drilling OR completions, candidate must have at least one
  • upstream NOT "entry level", upstream experience but not junior
  • (drilling OR completion) AND offshore NOT graduate, combined

Tip: Because the search is semantic, you don't need to list synonyms. "subsea" will match candidates with relevant deepwater and offshore pipeline experience even if they use different terminology.

Setting criteria

Required keywords, these must be conceptually present on the CV. Missing ones are flagged in red on the result card so you can see exactly what's absent.

Location filter, e.g. "UK", "Aberdeen", "Nigeria". The AI interprets this intelligently, "UK" will match candidates based in England, Scotland, Wales.

Nationality filter, e.g. "British", "Nigerian". Useful for roles with visa or right-to-work requirements.

Industries must include, click the industry tags to require that a candidate has worked in specific sectors. "Oil & Gas" and "Oilfield Services" are separate, SLB/Halliburton is Oilfield Services, Shell/BP is Oil & Gas.

Minimum years, set both total career years and minimum relevant years (requires a job spec to be uploaded to calculate relevant years).

Custom categories, rename the result categories to match your process. Click any category label to rename it.

Job spec upload

Upload the full job description as a PDF. Lucuma reads it and uses it to:

  • Calculate how many years of each candidate's experience is relevant to this specific role
  • Improve the accuracy of the boolean and keyword matching
  • Produce more precise AI summaries tailored to the role

Without a job spec: Lucuma can still screen and score candidates, but relevant years will not be calculated and some accuracy is reduced. The job spec is optional but strongly recommended.

Uploading CVs

Drag and drop multiple PDF files at once onto the upload area, or click to browse. PDFs work best. Word documents (.docx) are also supported.

CVs that do not contain sufficient data to screen accurately, no employer names, no job titles, no career timeline, are separated into a Manual review required list. They are never scored on incomplete information.

You can cancel a screening run in progress using the Cancel button that appears in the header. Processing stops after the current CV completes.

Reading results

Results are grouped by your custom categories (Strong Match, Good Match, etc.) and sorted by score within each category. Click any result card to expand it.

Each expanded card shows:

  • Score (0–100) and category
  • Boolean query satisfaction and any required keywords found or missing
  • Full employment history with employer, role, industry label and approximate years
  • Total and relevant years of experience
  • AI-generated strengths and watch points, based only on what the CV states
  • Filter match indicators (location, nationality, industry, years)

Accuracy note: Every score is based on data that was explicitly stated in the CV. Lucuma does not guess or infer. If the AI had insufficient data to screen a CV reliably, it appears in the Manual Review section instead of the scored results.

Pipeline / CRM

Add candidates to your pipeline directly from a result card. The Pipeline tab shows a kanban board with six stages: New, Shortlisted, Interview, Offer, On Hold, Not Suitable.

For each candidate in the pipeline you can:

  • Move them between stages
  • Set priority (High, Medium, Low)
  • Add a next action note
  • Write and save recruiter notes
  • View their contact details (email and phone, if on CV)

Pipeline data is included in CSV exports so you can take it into any other system.

Comparing candidates New

Select up to 4 candidates for side-by-side comparison. Open any result card and click ⊕ Compare. Once you have 2 or more selected, go to the Compare tab for a full structured table showing score, role, employer, industry, experience, strengths and watch points across all selected candidates.

This is particularly useful when presenting a shortlist to a client or making a final shortlisting decision.

Saved templates New

If you fill the same type of role repeatedly, save your criteria as a named template. Go to the Templates tab, name the template (e.g. "Senior Drilling Engineer UK") and click Save.

Saved templates store your boolean query, required keywords, all filters, and custom categories. Load one with a single click to populate all criteria instantly.

Note: Templates are currently saved in your browser. They will be stored to your account in a future update.

Sharing reports New

Generate a shareable link your client can open in their browser, no login required on their end. The link contains all screening results interactively. Click 🔗 Share report in the header after screening.

You can add an optional note to the client before copying the link. Send it via email for best results, the link is long and may be truncated by WhatsApp or SMS.

White label Agency+

Available on Agency and Enterprise plans. Go to the White Label tab to replace all Lucuma branding with your own logo, company name, tagline and accent colours. Changes apply instantly across the entire app and all exports.

Enterprise clients can deploy on their own domain. Contact hello@marvanova.com to arrange this.

Common questions

Why is a CV in the manual review list? It lacked sufficient data to screen accurately, typically missing employer names, job titles or dates. Review it directly and decide whether to include it in your shortlist.

Can I rerun a screening with different criteria? Yes, change your criteria on the Criteria tab and click Run Screening again. The CVs you uploaded are still queued until you remove them.

Are candidate CVs stored? No. CV data is processed in memory to generate results and is not stored on our servers after your session.

Why does a candidate have a low score despite looking strong? Check which filters they failed, open the result card and look at the match pills (Boolean, Location, Keywords etc.). The score reflects how well the candidate meets your specific criteria, not their absolute quality.

I need help or have feedback. Email hello@marvanova.com, we respond within one business day.