ats-optimization

Check a resume for ATS-hostile formatting, keyword gaps, and narrative weaknesses, then propose specific inline fixes. Invoke resume-coach to perform the analysis.

This skill fires automatically when a resume has just been generated (after tailor-resume assembles a draft, before the user confirms the save) or when a resume is pasted into the conversation. It also fires on explicit request.

Workflow

1. Identify the resume

Check for a resume in context — in order of priority:

1. A resume just generated by tailor-resume in this session
2. Content pasted directly into the conversation
3. An artifact name or filename the user referenced — look it up in {user_dir}/CareerNavigator/artifacts-index.json and read the file

If no resume is identifiable:

"Which resume should I check? Paste it here or give me the filename."

2. Get the job description

A JD is required for keyword match analysis. Check for one in context:

• If tailor-resume just ran, the JD is already in context — use it
• If the user pasted a JD alongside the resume — use it
• If no JD is in context, ask:

  "Paste the job description so I can check keyword coverage. Skip it and I'll check formatting and narrative only."

If the user skips, proceed with formatting and narrative checks only — note that keyword match will be omitted from the results.

3. Invoke resume-coach

Pass the resume text and JD (if available) to resume-coach. The agent applies its ATS Scoring Rules and Narrative Coaching Rules and returns a list of issues: the check that failed, the offending text, and a proposed fix.

4. Present inline fix suggestions

Organize findings into a prioritized list — highest-impact issues first. For each issue, show the original and the proposed rewrite side by side:

ATS check — {filename or "this resume"}
{n} issue(s) found

1. {Check name}  [HIGH / MEDIUM / LOW]
   Original:  "{exact text from the resume}"
   Fix:       "{specific proposed rewrite}"

2. {Check name}  [HIGH / MEDIUM / LOW]
   Original:  "{exact text}"
   Fix:       "{specific rewrite or instruction if no direct replacement is possible}"

...