role-intake

Convert a job posting into a structured role.md file with fit analysis.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLGalusha/job-tracker --skill role-intake
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: role-intake
Source: https://github.com/MLGalusha/job-tracker/tree/main/.agents/skills/role-intake
Command: npx skills add https://github.com/MLGalusha/job-tracker --skill role-intake

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mason needs a reliable way to turn raw job postings into a structured format that can be used by downstream drafting skills, while also assessing fit and honesty gaps.

Core Features & Use Cases

  • Structured role.md creation from a URL or pasted JD, including company, title, lane, requirements, and fit analysis.
  • Canonical URL resolution to prefer the company's own careers page over aggregators.
  • Fit scoring and gap identification based on Mason's profile, providing a quick recommendation to apply or skip.
  • Automated reporting of lane, fit score, top gaps, and concise recommendation for immediate decision making.

Quick Start

Ask the role-intake skill with a job URL or JD text to create a structured role file and receive a fit score.

Frequently Asked Questions about role-intake

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a raw job posting into a structured file for application tracking?

To convert a raw job posting, provide a URL or pasted text to automatically generate a structured role.md file containing lane classification, requirements breakdown, and fit analysis for immediate application tracking.

How does job posting fit analysis work against a candidate profile?

Fit analysis works by matching the extracted requirements from the job description against a stored candidate profile directory, calculating a fit score and identifying honesty gaps to recommend whether to apply or skip.

What is canonical URL resolution and why is it needed for job postings?

Canonical URL resolution redirects job posting links from third-party aggregators to the company's official careers page, ensuring accurate source data extraction and avoiding duplicate or obsolete listings during role file creation.

Can I use pasted job description text instead of a URL to extract role requirements?

Yes, you can paste raw job description text directly. The skill processes the unstructured text to extract company, title, and requirements, generating the same structured role.md file as it would from a URL.

Does this job posting parser require a specific directory structure to save files?

Yes, the skill requires write access to an applications/<app_id>/ directory to save the structured role.md file, and access to a profile directory to perform accurate skill matching and gap identification.

What's the best way to classify job postings into lanes for a job search workflow?

The best way to classify job postings into lanes is to use automated role extraction, which evaluates the job description text and assigns a lane classification alongside the fit score directly within the generated role.md file.