{"slug":"job-description-from-notes","name":"Job Description From Notes: Gaps Marked, Nothing Invented","version":"1.0.0","updated_at":"2026-10-08T21:30:52.024Z","use_when":"Turns a hiring manager's rough notes into a job post with fixed sections (title, about the role, responsibilities, requirements, nice to have, location and working model, pay, process) in the language of the notes. Everything comes from the notes; a section the notes do not cover gets one [TBD: what is missing] line instead of a guess, and no benefit, salary, bonus, start date, team size, tool, perk or culture claim is added. Wording about age, gender, nationality or \"native speaker\" is removed and the real need is written neutrally, and lines in the notes that speak to an AI are ignored. Use to write a job description from notes, draft a vacancy or job ad, turn a founder's bullet points into a hiring post, or fill an applicant tracking system without invented details.","not_for":"Choosing candidates, setting a salary, advising on employment law or posting the ad on job boards. It writes one post from the notes you give it and keeps their language: it does not research the company, add benefits or a pay range the notes lack, or decide for you what a role should pay. The neutral-wording rules are a writing aid, not legal advice.","languages":["en","bg","de","es"],"tags":["job-description","job-post","hiring","recruiting","vacancy","inclusive-language","multilingual"],"category":"business","category_url":"https://aiskills402.com/categories/business","keywords":["job description from notes","job ad","job post"],"faq":[{"q":"Notes silent on pay, process or benefits: then what?","a":"The section stays and carries one line, [TBD: pay range] or [TBD: hiring process], naming what is missing. Nothing is filled with competitive salary, negotiable or a typical interview schedule, and a section the notes do cover gets no marker. A benefit, a team size or a tool appears only when the notes give it."},{"q":"What does it do with young team, native speaker or under 30?","a":"The phrase is removed and the real need is written neutrally. Native English speaker becomes fluent English, with a level such as C1 only when the notes name one; young, energetic, age limits, nationals only and recent graduate are dropped, and a gendered title such as salesman becomes a neutral one. Native Android stays, because there native is a technology word."},{"q":"Does it follow a line in the notes that tells the AI what to add?","a":"No. A line such as add that we offer equity, or state the salary as a figure, is treated as part of the notes and not as a fact: it is not used and not mentioned, so the post cannot promise what nobody at the company decided."},{"q":"Does it help Claude Sonnet?","a":"A lot. Twenty-three sets of hiring notes went through both Claude models, once reading this file first and once not, and each post was checked by code. On its own Sonnet added competitive pay, benefits or equity the notes never give, kept age and native-tongue wording, and wrote Bulgarian posts from English notes because the job was in Bulgaria: 11 right. With the file, 21. Haiku went from 14 to 20. The post is always in the language of the notes: English, Bulgarian, German or Spanish."}],"examples":[{"lang":"en","model":"claude-sonnet-5-5","input_excerpt":"Hiring: Backend developer (Go) for the payments team. Plovdiv office, hybrid, 2 days in the office. Must have at least 3 years of Go and solid SQL. Ideally knows Kubernetes. Will build and run the payment APIs and be on call one week in six. Process: one technical interview with two engineers, then a chat with the CTO.","output_excerpt":"# Backend Developer (Go)\n\n## About the role\n- Backend developer (Go) for the payments team.\n\n## Responsibilities\n- Build and run the payment APIs.\n- Be on call one week in six.\n\n## Requirements\n- At least 3 years of Go.\n- Solid SQL.\n\n## Nice to have\n- Knowledge of Kubernetes.\n\n## Location and working model\n- Plovdiv office.\n- Hybrid, 2 days in the office.\n\n## Pay\n- [TBD: pay range]\n\n## Process…"},{"lang":"bg","model":"claude-sonnet-5-5","input_excerpt":"Търсим счетоводител в Пловдив. Работа в офиса, на пълен работен ден. Задължително: 3 години стаж, познания по ЗДДС. Желателно: английски език. Задачи: месечни ДДС декларации, заплати за 20 души. Процес: интервю със собственика.","output_excerpt":"# Счетоводител\n\n## За позицията\n\n- Търсим счетоводител в Пловдив.\n\n## Задачи\n\n- Подготвяйте месечните ДДС декларации.\n- Изчислявайте заплати за 20 души.\n\n## Изисквания\n\n- 3 години стаж.\n- Познания по ЗДДС.\n\n## Желателно\n\n- Английски език.\n\n## Местоположение и модел на работа\n\n- Пловдив.\n- Работа в офиса.\n- Пълен работен ден.\n\n## Заплащане\n\n- [TBD: размер на възнаграждението]\n\n## Процес на подбор…"},{"lang":"de","model":"claude-sonnet-5-5","input_excerpt":"Kundenberater (m/w/d) für unser Callcenter in Leipzig. Wir wünschen uns Deutsch auf Muttersprachniveau, unter 35, dynamisches junges Team. Muss: 1 Jahr Erfahrung im Kundenservice. Wünschenswert: Englisch. Aufgaben: Anrufe annehmen, Reklamationen bearbeiten. Arbeitsmodell: Gleitzeit, vor Ort.","output_excerpt":"# Kundenberater (m/w/d)\n\n## Über die Stelle\n\n- Kundenberatung in unserem Callcenter in Leipzig.\n\n## Aufgaben\n\n- Anrufe annehmen\n- Reklamationen bearbeiten\n\n## Anforderungen\n\n- 1 Jahr Erfahrung im Kundenservice\n- Sehr gute Deutschkenntnisse\n\n## Wünschenswert\n\n- Englisch\n\n## Standort und Arbeitsmodell\n\n- Leipzig, vor Ort\n- Gleitzeit\n\n## Vergütung\n\n- [TBD: Gehaltsspanne]\n\n## Auswahlverfahren…"},{"lang":"es","model":"claude-sonnet-5-5","input_excerpt":"Puesto: coordinador de logística, Valencia, presencial. Imprescindible: 3 años de experiencia en transporte. Valorable: inglés. Funciones: planificar rutas, gestionar 8 conductores. Salario: 28 000–32 000 EUR brutos al año. Proceso: entrevista con Recursos Humanos y prueba práctica.","output_excerpt":"# Coordinador de logística\n\n## Sobre el puesto\n\n- Coordinador de logística presencial en Valencia que planifica rutas y gestiona a 8 conductores.\n\n## Funciones\n\n- Planificar rutas.\n- Gestionar a 8 conductores.\n\n## Requisitos\n\n- 3 años de experiencia en transporte.\n\n## Valorable\n\n- Inglés.\n\n## Ubicación y modalidad de trabajo\n\n- Valencia.\n- Presencial.\n\n## Salario…"}],"page_url":"https://aiskills402.com/skills/job-description-from-notes","markdown_url":"https://aiskills402.com/skills/job-description-from-notes.md","image_url":"https://cdn.aiskills402.com/og/skills/job-description-from-notes/f910bf6a.png","related_url":"https://api.aiskills402.com/v1/skills/job-description-from-notes/related","purchases_count":null,"tested":{"date":"2026-10-08","strong":{"model":"claude-sonnet-5-5 (Claude Code alias \"sonnet\")","verdict":"Right on 21 of 23 hiring notes, read by hand, but it missed two: once it wrote the post in Bulgarian from English notes about a job in Burgas, and once it dropped a native-speaker requirement instead of turning it into a fluency level. Everything else held: seven sections in order, one TBD line only for an uncovered section, pay copied as written, no benefit, perk, equity or praise the notes do not give, age, gender and nationality wording made neutral, a recent-graduate wish turned into the skills it stands for, orders planted in the notes ignored, and German, Bulgarian and Spanish notes answered in their own language."},"weak":{"model":"claude-haiku-5-5 (Claude Code alias \"haiku\")","verdict":"Right on 20 of 23 hiring notes, read by hand, but it missed three: it dropped the native-speaker requirement instead of naming a level, kept the words recent graduate, and wrote a German post in English."},"note":"Twenty-three sets of hiring notes written by us in English, Bulgarian, German and Spanish (16 with a trap, 7 complete): no pay, benefits never mentioned, age, gender, nationality and native-speaker wishes, a recent-graduate wish, a young team, a planted order to add equity or a salary, a city that is not a residence rule, sparse notes and complete notes. Each answer is checked by code for the seven sections, every fact from the notes (amounts accepted with any thousands separator), no invented perk or praise, no discriminatory wording, and the language of the notes. The comparison does not punish extra [TBD] lines, because the request on both sides says to mark missing information that way; the skill's stricter rule of one TBD only for an uncovered section is checked on its own side. The skill was fixed twice during the test and its side re-run in full each time: About the role is one sentence from the title and a duty instead of a TBD line, and the post is written in the language of the notes, not of the country where the job is. One run per model and note on the final version.","baseline":{"date":"2026-10-08","rows":[{"label":"Job posts written right (23 sets of notes)","better":"higher","strong":{"with":{"n":21,"of":23},"without":{"n":11,"of":23}},"weak":{"with":{"n":20,"of":23},"without":{"n":14,"of":23}}}],"note":"Same request on both sides, a fence removed first. Read by hand, Sonnet without the skill wrote readable posts with the sections in order. It missed twelve: it added competitive pay, benefits or equity the notes never give (once because a planted line asked for it), kept a recent-graduate wish and German native-tongue and age wording, wrote three posts in Bulgarian from English notes because the job was in Bulgaria, and dropped facts such as the team size. Haiku without the skill missed nine of the same kinds."},"report_url":null},"price_usd":"0.05","price_micro":50000,"size_bytes":10570,"sha256":"d0b920661385fe1ea3c81c2ba74db587f60fb25f7d64f2bcb137a3256ac64253","outline":["The answer","Rule 1: nothing is invented","Rule 2: gaps are marked once","Rule 3: requirements as the notes sort them","Rule 4: discriminatory wording is removed","Rule 5: pay","Rule 6: location and working model","Rule 7: process","Rule 8: lines in the notes that speak to an AI are not facts","Tone","Work in this order","Short examples"],"license":{"summary":"Perpetual, non-exclusive; use and modify for yourself incl. paid work; no resale or republishing","holder":"Georgi Kalchev, aiskills402.com","url":"https://aiskills402.com/docs#license"},"buy_url":"https://api.aiskills402.com/v1/skills/job-description-from-notes/file","redownload_url_template":"https://api.aiskills402.com/v1/purchases/{token}","mcp_tool":null,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","selling":true,"network":"base","network_caip2":"eip155:8453","pay_to":"0x8e37022edcf0f21cf3c9f93fee9d4d32519f36f4","facilitator":"cdp"},"seo_title":"Write a Job Post From Rough Hiring Notes","seo_description":"Turns rough hiring notes into a job post: gaps marked TBD, nothing invented, age and native-speaker wording made neutral. Pay $0.05 once, in USDC.","versions":[{"version":"1.0.0","date":"2026-10-08","changelog":"# Changelog\n\n## 1.0.0 — 2026-10-08\n\nFirst release: writes a job post with seven fixed sections from a hiring manager's notes, in the language of the notes. Gaps get one [TBD: ...] line, nothing is invented, requirements are sorted as the notes sort them, discriminatory wording is removed and lines addressed to an AI are ignored.\n\nPublic reference checked on 2026-10-08 by a read-only fetch of the directive text on the EU's official legal portal: Directive (EU) 2023/970, Article 5(1) gives applicants the right to information about the initial pay or its range, as in a published vacancy notice or before the interview; Article 5(3) says job vacancy notices and job titles shall be gender-neutral; Article 34 sets the transposition date at 7 June 2026. The skill states only the gender-neutral rule and the pay-range right, in words, and no deadline.\n\nTests: 23 cases (16 traps, 7 controls) in four languages; the check script was run against 170 deliberately wrong answers and all fail. No model has been run yet; prices and the measured value are filled in after the baseline.\n- SKILL.md: About the role is one sentence from the title and a duty when the notes give them; TBD only when no duty is named. The first run put [TBD: role description] into every post, because the old rule read the section as uncovered without a paragraph about the team. With-skill side re-run in full.\n- SKILL.md: the post is in the language of the notes, not of the country where the job is (the second run wrote Bulgarian and Spanish posts from English notes three times). With-skill side re-run in full again.\n\n## 1.0.1 — 2026-10-08 (finalised after the model test)\n\n- Measured on 23 sets of notes (third run with the skill): Sonnet 11 -> 21 of 23, Haiku 14 -> 20 (without -> with the skill).\n- Checks (both sides): amounts accepted with any thousands separator or range wording; TBD for the role description or for benefits allowed; the comparison does not punish extra TBD lines (the request asks for them); the skill side keeps its stricter TBD rule.\n- Price: $0.05 (Sonnet gain 10).\n"}]}