Follow this guide to turn your role notes into a high‑signal post your future hire can’t ignore.
Why it matters
Feeds the Hiring Brain – we parse responsibilities, skills, and context to rank candidates on real fit, not buzzwords.
Saves time downstream – clear expectations reduce mis‑hires and back‑and‑forth questions.
Boosts employer brand – human, inclusive language shows you value transparency and culture.
Core ingredients
Section | Purpose | Tips |
Role title | Catch attention & set expectations | Avoid jargon; add level & specialty (e.g., IT Deskside Support Technician – Tier 2) |
Mission / “Why” | Give the work meaning | 1–2 sentences on impact (how the role supports customers, team, or product) |
Key responsibilities | Define day‑to‑day tasks | 5–8 bullets, verb‑led, include metrics (e.g., Resolve 25+ tickets/week within SLA) |
Must‑have skills | Hard filter for matching | List technical tools, certifications, or domain expertise |
Values & soft skills | Culture and mindset fit | Tie to company principles (e.g., Ownership – you fix or escalate, never ignore) |
Success metrics | What “great” looks like | Time‑bound outcomes—first 90 days, 6–12 months |
Compensation & perks | Build trust & compliance | Salary range, benefits, remote policy, growth paths |
Location & schedule | Avoid surprises | On‑site vs remote, shifts, travel %, time zones |
About the company | Sell the bigger story | Keep it to 3–4 punchy lines; link to careers page |
Step‑by‑step in Truffle
Open Job setup → Job description
Paste or type each section using the rich‑text toolbar
Headings for major sections (## Responsibilities)
Bullets for lists; keep lines under 20 words
Bold any critical “must‑have” phrases
Click Preview to see exactly what candidates will read
Save and continue to Intake—Truffle will scan the text and suggest qualification + screening questions within seconds.
Writing best practices
Front‑load must‑haves – candidates skim; list deal‑breakers early.
Use measurable verbs – reduce, launch, design, mentor.
Stay inclusive – swap gendered words (rockstar, ninja) for neutral skills.
Limit acronyms – spell out at first mention (Jira Service Management (JSM)).
Show growth – add a line on career pathway or learning budget.
Word count sweet spot
400–600 words outperforms ultra‑short or essay‑length posts in conversion and matching accuracy.
Example snippet
ROLE SUMMARY The Deskside Support Technician keeps 300+ brewery staff online by troubleshooting hardware, software, and network issues on‑site and via Zoom. You’ll own our ticket queue (Jira), drive a sub‑24‑hour SLA, and lead the quarterly laptop refresh across 10 locations.
Do’s and Don’ts
✅ Do | ❌ Don’t |
Use second person (“you will…”) | Stuff 20+ bullets under responsibilities |
Group tasks by theme | Bury compensation in fine print |
Mention tooling stacks | Require obscure degrees if skills suffice |
Share team rituals (stand‑ups, retros) | Use tired clichés (work hard, play hard) |
FAQs
What happens if I update the description after launch?
Truffle re‑analyzes the text and refreshes match rankings for all new applicants. Current candidates remain unaffected.
Can I paste rich formatting from Word or Google Docs?
Yes—our editor cleans most styles automatically, but double‑check headings.
How detailed should the company bio be?
Aim for 3–4 lines; link out to About us for the full story.
Next up
Fill the Intake prompts to teach Truffle what success looks like
Add Qualification questions to keep your pipeline tidy