Home / Managers and hard messages at work / Read a job post for what the job really is

Read a job post for what the job really is

Who it is for
Job seekers deciding whether to apply.
What you give it
The job post, and your background if you like.
What you get back
Firm and wish requirements, what is missing and questions for the recruiter.

Get the files from GitHub (for developers)

A text you paste into ChatGPT, Claude or any chatbot.

Free. MIT licence: use it, change it, share it.

Before and after

Before: Reading a long ad twice and still not knowing what the role is or whether to apply.

After (real output, from a real test run): Test run on a real public job post for a senior product marketing role. It noticed the post was cut off mid-sentence, said the post gave no firm requirements list, listed pay, location, hours and how to apply as missing, quoted five phrases with a question for each (for example "high-performance culture"), and told a marketing coordinator that this looked like a hard first step and an associate-level role might be a better one. It invented no experience.

What it does

Paste a job post. It says in plain words what the job is, sorts the requirements into firm, wish and unclear with quotes, lists what the post leaves out (pay, location, hours, team), points out phrases worth a question, and gives you six to eight questions for the recruiter. If you add your background, it says where the fit is strong or weak and what to lead with. It never says anything about the employer beyond the post.

The evidence

1 run on a real public job post (Claude).

Limits

  • It works only from the post. It cannot tell you what the company is like.
  • Phrases it flags are prompts for questions, not proof of anything.
  • If the post is cut off, it says so and works with what is there.
  • It does not call a post a scam.

Questions

Questions or a problem?

Use the contact page.

Contact page

Which assistants does it work with?

Works in ChatGPT or any chatbot: you paste in your details and it writes the result.

For technical users

Using it with an AI assistant

  1. Run npx skills add proskillpacks/skills in your project and pick this skill. Or copy the job-post-decoder folder from GitHub (https://github.com/proskillpacks/skills/tree/main/skills/careers/job-post-decoder).
  2. Put the job-post-decoder folder where your assistant looks for skills. The generic path is .agents/skills/ (or npx skills add from a folder). Tool-specific paths:
    • Claude Code: ~/.claude/skills/ (or .claude/skills/ inside one project)
    • OpenAI Codex, Gemini CLI, Cursor and others: .agents/skills/ or the skills folder their docs name
    • claude.ai: zip the skill folder yourself, then Customize, Skills, the plus button, Create skill, Upload a skill (code execution must be on in Settings, Capabilities)
    • ChatGPT or any chatbot: open the skill's prompt.md, paste it into the chat, then paste your own text or link
    • Steps for each tool, with links to its official docs: how to install skills
  3. Ask for the job in plain words, for example: "Decode this job post for me. I'm a ... who wants to move into ...". The skill loads by itself.
Copy the text for ChatGPT or any chatbot

Jobs that go with this