hiring-kit

v1.0.0 MIT growth updated 2026-09-27

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.py builds a hiring kit from role.json — a formatted job-post.md (title, location/pay/type header, duties, must-haves, nice-to-haves, how to apply) plus an interview-scorecard.md rating every must-have (and communication + reliability) on a defined 1-5 scale, with totals and a hire/no-hire recommendation. Includes references/interview-guide.md.

← back to catalog