Job Description Ontology
Models public-facing job descriptions/postings across industries, capturing the sections, attributes and axes of variation needed to generate a new realistic job posting from a short prompt.
hiring · 34 concepts · 42 relationships · by @ssergienko · CC BY 4.0
Classes (10)
- Job Posting
- The complete document advertising an open position to candidates.
- e.g. Senior Data Engineer posting · Store Manager posting
- Employer
- The organisation hiring, described briefly.
- e.g. Alderfield Insights, a 200-person Series C startup · Cedar Lane Grocers, a regional grocery chain
- Role
- The position being filled, including title, level, team and reporting line.
- e.g. Staff Backend Engineer · Pharmacy Shift Supervisor
- Header Block
- Top-of-document summary line(s) with title, company, location, work mode, employment type and pay.
- e.g. Title · Remote (EU) · Full-time · €60k–€75k · Company: X — Location: Y — Reports to: Z
- About Us Section
- Short employer pitch with product, scale, size and funding.
- e.g. We build logistics software used by 800 warehouses.
- Role Summary Section
- Brief paragraph of what the hire will do and own, including team size.
- e.g. You will join a 6-person platform team and own CI tooling.
- Responsibilities Section
- Bulleted list of 4–6 duties starting with action verbs.
- e.g. Design and maintain data pipelines · Hire, train and schedule associates
- Qualifications Section
- Requirements the candidate should meet, optionally split into must-have and nice-to-have.
- e.g. 4+ years in QA automation · Forklift certification within 30 days
- Benefits Section
- Perks and non-salary benefits, as list or inline.
- e.g. 30 days paid holiday · 401(k) with 4% match · €1,000 learning budget
- Hiring Process
- Sequence of interview stages and response time.
- e.g. Intro call → take-home → panel interview · We reply within 5 working days
Dimensions (6)
- Industry / Domain
- Sector of the employer and role.
- e.g. healthtech · grocery retail · logistics
- Seniority Level
- Career level of the role.
- e.g. junior · mid · senior
- Work Model
- Remote, hybrid or on-site.
- e.g. remote · on-site · hybrid
- Region / Locale
- Geography determining currency, legal norms and benefit conventions.
- e.g. EU · US-Texas · UK
- Role Type (knowledge vs operational)
- Whether the role is knowledge-work or operational/frontline.
- e.g. engineering · store operations
- Company Size & Stage
- Headcount and funding stage.
- e.g. Series B, 140 people · regional chain, 40 stores
Properties (12)
- Job Title
- Name of the position, often with seniority prefix.
- e.g. Senior Data Engineer · Store Manager
- Location & Work Mode
- Where the work is done: remote, hybrid or on-site, with city or time-zone constraints.
- e.g. Remote (EU time zones) · Denver, CO, on-site
- Employment Type
- Contract basis and hours/status.
- e.g. Full-time · Part-time · Full-time, exempt
- Compensation
- Salary range, currency and variable pay or equity.
- e.g. €70,000–€85,000 + equity · $55,000–$65,000 + quarterly bonus up to 8%
- Reports To
- Manager or function the role reports to.
- e.g. District Manager · Head of Engineering
- Must-Have Requirements
- Mandatory qualifications.
- e.g. Strong SQL and Python · High school diploma required
- Nice-to-Have Requirements
- Optional preferred qualifications.
- e.g. Terraform · Bachelor's degree a plus
- Years of Experience
- Minimum experience threshold.
- e.g. 3+ years · 5+ years
- Skills / Tools
- Named technologies, tools or competencies.
- e.g. Airflow, dbt, Kafka · POS systems, inventory software
- Physical & Legal Requirements
- Lifting, schedule availability, certifications, background checks.
- e.g. Able to lift 40 lbs · Background check required
- Schedule
- Hours per week and shift pattern.
- e.g. 45 hours/week, rotating shifts
- Application Deadline / Call to Action
- How and by when to apply.
- e.g. Apply by 30 November
Values (2)
- Work Mode Values
- Enumerated work modes.
- e.g. Remote · Hybrid · On-site
- Employment Type Values
- Enumerated contract types.
- e.g. Full-time · Part-time · Contract
Relations (1)
- Team & Scope Metrics
- Quantified scope tying role to the organisation, such as team size, budget or headcount managed.
- e.g. Lead 25–35 associates · manage a $4M P&L · 5-person team
Constraints (3)
- Equal Opportunity Statement
- Closing statement of non-discrimination.
- e.g. X is an equal opportunity employer.
- Structural Convention
- Postings are concise, scannable and bulleted, with section headings in a consistent order: header, intro/summary, responsibilities, qualifications, benefits, process/legal.
- e.g. Heading + 3–6 bullets per section
- Internal Consistency
- Pay, seniority, experience years and responsibilities must be coherent with each other and the region.
- e.g. Senior role with 5+ years and mentoring duty