---

name: ats-refinement description: ATS scoring integration, analysis, optimization suggestions, format compatibility checks, and score tracking. Use when asked to improve ATS scores, interpret Jobscan results, or generate ATS-safe recommendations.

ATS Refinement

Quick Start

• Run ATS scan or ingest existing score data.
• Analyze component scores and issues.
• Generate prioritized, evidence-based suggestions.

Inputs

• Resume data and job description.
• Jobscan scan ID or raw ATS response.
• Optional: target ATS systems for format checks.

Outputs

• ATS score breakdown and analysis report.
• Prioritized optimization suggestions.
• Format compatibility report and recommendations.
• Score history and trend data.

Workflow

1. Authenticate and call ATS scan; cache results by resume+job hash.
2. Parse scores and issues into standard components.
3. Generate analysis report and rank weaknesses.
4. Produce suggestions with impact and difficulty estimates.
5. Validate ATS format compatibility across major ATS systems.
6. Track scores over time and surface trends.

Truthfulness Guardrails

• Suggest only changes supported by existing resume evidence.
• Reject any invented experience or claims.

Quality Gates

• Suggestion count 5-15 with clear quick wins.
• ATS format checks P95 < 500ms.
• ATS suggestion generation P95 < 2s.

Use References and Templates

• For commands and hooks, read references/commands.md and references/hooks.md.
• For suggestion templates, use files in assets/templates/.