All skills / Job seekers and careers

Job Post Decoder

Paste a job post. Get what the job is, firm and wish requirements, what is missing and questions for the recruiter. Free, MIT-licensed.

Free, MIT licence, hosted on GitHub. Install the whole free set with npx skills add proskillpacks/skills, or copy this skill's folder.

What you give it

Paste a job post.

What you get

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.

Before and after

Taken from the skill's README.

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

After (skill 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.

How it was tested

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

Tested on a real example before release. The example is shown in the Before and after section above.

How we test, what we do not do, and which assistants we ran it on.

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.

Works with

Works in ChatGPT or any chatbot: you paste in your details and it writes the result. The chargeback kit also has Word letters you can fill in by hand, with no AI.

For people who use AI assistants

  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 Agent 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.

Get it

MIT licence. Use it, change it, share it.

Related

Report a problem with this skill (GitHub, or write to kaiventura.founder@gmail.com).