hiring-kit
Turn a role.json (title, duties, must-haves, pay range, location) into a formatted job-post markdown file plus a companion interview scorecard that rates each must-have on a 1-5 scale. Use when hiring and wanting a clear public posting plus a fair, consistent way to compare candidates.
$ skillbank install hiring-kit@1.0.0 # pins exactly 1.0.0 · README + changelog included
Hiring Kit
Overview
Writing a job post from scratch invites vague wish-lists; interviewing without a scorecard invites gut-feel hiring. post.py fixes both from one role.json: it generates a clean, postable job-post.md (what the job is, what it pays, what you need, how to apply) and an interview-scorecard.md where every must-have becomes a 1-5 rated criterion, plus communication and reliability.
The scorecard exists so you compare candidates against the same bar instead of against each other — or against whoever interviewed best last week.
All data stays local — nothing is uploaded anywhere.
Installation
1. Copy the hiring-kit/ directory anywhere convenient. 2. Make the script executable (Unix):
chmod +x scripts/post.py
No pip install needed — standard library only.
Configuration
One input file, role.json. Required fields: title, duties (array), must_haves (array). Optional: location, pay_range, employment_type, summary, about_company, nice_to_haves (array), apply_instructions.
{
"title": "Delivery Driver",
"location": "Allentown, PA",
"pay_range": "$18-22/hr",
"employment_type": "Full-time",
"summary": "Deliver bakery orders across the Lehigh Valley in our company van.",
"about_company": "Maple St Bakery is a family-run bakery serving the Lehigh Valley since 2011.",
"duties": ["Load the van and run the daily delivery route",
"Collect payment and signatures on delivery"],
"must_haves": ["Valid driver's license with a clean record",
"Able to lift 50 lbs repeatedly"],
"nice_to_haves": ["Familiarity with the Lehigh Valley area"],
"apply_instructions": "Email your resume to jobs@example.com with subject line 'Driver'."
}
Put the pay range in. Posts with pay get more and better applicants, and you'll waste less of everyone's time.
Inputs
| Flag | Required | Description | |---|---|---| | --role | yes | Path to role.json | | --out | no | Output directory (default hiring-kit) |
Writes job-post.md and interview-scorecard.md into the output directory. Missing required fields stop the run with a named error. Exit codes: 0 = ok, 2 = bad/missing input.
Worked example
$ ./scripts/post.py --role role.json --out kit
wrote kit/job-post.md
wrote kit/interview-scorecard.md
done: hiring kit for 'Delivery Driver' in kit/
kit/job-post.md:
# Delivery Driver
**Location:** Allentown, PA | **Pay:** $18-22/hr | **Type:** Full-time
Deliver bakery orders across the Lehigh Valley in our company van.
## About us
Maple St Bakery is a family-run bakery serving the Lehigh Valley since 2011.
## What you'll do
- Load the van and run the daily delivery route
- Collect payment and signatures on delivery
- Keep the van clean and report maintenance issues
## Must-haves
- Valid driver's license with a clean record
...
kit/interview-scorecard.md opens with candidate/date/interviewer fields, a 1–5 rating scale with plain definitions, then one row per must-have plus communication and reliability, each with space for evidence and a score — closing with a total and a hire/no-hire recommendation box.
See references/interview-guide.md for how to run the interview fairly.
Version history
Changelog
1.0.0 — 2026-09-27
- Initial release:
scripts/post.pybuilds a hiring kit from role.json — a formattedjob-post.md(title, location/pay/type header, duties, must-haves, nice-to-haves, how to apply) plus aninterview-scorecard.mdrating every must-have (and communication + reliability) on a defined 1-5 scale, with totals and a hire/no-hire recommendation. Includesreferences/interview-guide.md.