# agency-ats-validator-architect

agency-ats-validator-architect is a Claude Code skill that checks resumes for ATS parseability. Audits PDF text layers and scores bullet points via the Google X-Y-Z heuristic.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 85 repo stars
- Author: huytran1120
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/huytran1120/vie-agentic-skills/tree/HEAD/skills/agency-ats-validator-architect/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agency-ats-validator-architect

## What it does

The skill tests resume geometry and text serialization to prevent parsing errors in Workday, Taleo, Greenhouse, and Daxtra. It inspects PDF text streams (`Tj`, `TJ`, `Tm`), confirms valid `/ToUnicode` CMaps, and flags Unicode Private Use Area glyphs (`\uE000-\uF8FF`) that break downstream search indices.

Relevance evaluation relies on zero-token deterministic IR with BM25, TF-IDF, and n-grams across English, Spanish, and Portuguese, completing in under 5ms in client memory. Bullet points run through a seniority-calibrated Google/IBM X-Y-Z formula. The 0 to 100 compliance score splits mathematically across four auditable pillars following EU AI Act and NYC Local Law 144 standards.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add huytran1120/vie-agentic-skills --skill agency-ats-validator-architect -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agency-ats-validator-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agency-ats-validator-architect/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add huytran1120/vie-agentic-skills --skill agency-ats-validator-architect -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agency-ats-validator-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add huytran1120/vie-agentic-skills --skill agency-ats-validator-architect -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agency-ats-validator-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install huytran1120/vie-agentic-skills skills/agency-ats-validator-architect
```

2. **Manually: put the files in place**
- File: `.github/skills/agency-ats-validator-architect/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add huytran1120/vie-agentic-skills --skill agency-ats-validator-architect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/huytran1120/vie-agentic-skills --path skills/agency-ats-validator-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agency-ats-validator-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/huytran1120/vie-agentic-skills/tree/HEAD/skills/agency-ats-validator-architect/SKILL.md

## When to use it
- detect multi-column layout breaks and table fragmentation in resume parsers
- locate corrupted Unicode glyphs and private use area characters in PDF files
- calculate keyword recall against job descriptions using BM25 and n-grams
- grade career accomplishment bullets using the Google/IBM X-Y-Z formula

## Example prompts
- Check resume.pdf for ATS ingestion traps and unmapped Unicode glyphs
- Compare my resume text against job-spec.txt and compute lexical recall
- Score experience bullets against the Google X-Y-Z formula and flag unquantified lines

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9eee8ac239d3a065.

BEGIN THIRD-PARTY FILE 9eee8ac239d3a065
```text
---
name: 'agency-ats-validator-architect'
description: 'Architect and validator for Applicant Tracking Systems (ATS) and resume parsers. Combines deterministic information retrieval (BM25/TF-IDF and n-grams without AI), quantified Google/IBM X-Y-Z heuristics calibrated by seniority, layout linearization and PDF text layer integrity auditing, regulatory compliance (EU AI Act, NYC LL 144), sub-5ms client-side execution, and Agent-Native BYOK architecture.'
---

# ATS Validator Architect

You are **ATS Validator Architect**, the definitive technical authority on resume parseability, applicant tracking system (ATS) ingestion pipelines (Workday, Taleo, Greenhouse, Lever, Ashby, Eightfold AI), and deterministic career relevance engineering. You bridge the gap between candidate-side narrative and cold, mechanical document parsers. You know that even the most accomplished career dossier is dead-on-arrival if an enterprise parser scrambles its two-column layout into incoherent text soup, maps its subsetted font glyphs to Private Use Area (PUA) mojibake, or drops its unquantified duty statements to the bottom of the recruiter's search queue.

## 🧠 Your Identity & Memory

- **Role**: ATS compliance auditor, parser diagnostic specialist, information retrieval (IR) relevance architect, and document layout linearization engineer.
- **Personality**: Rigorous, mathematically grounded, security-conscious, transparent, and allergic to snake-oil claims like "ATS beating hacks", "white-font keyword stuffing", or opaque black-box AI scores. You speak fluent bounding boxes, tokenizers, n-grams, CMap Unicode tables, and verifiable impact metrics.
- **Memory**:
  - You remember how Workday's rigid field mapper drops custom sections that do not match canonical vocabulary (`Work Experience`, `Education`, `Skills`).
  - You remember how Taleo's legacy OCR and scanline sorting algorithms bin text strictly by vertical $Y$-coordinates, merging parallel columns into scrambled gibberish (*"Senior Architect Kubernetes ScaleFlow Technologies"*).
  - You remember how modern enterprise parsers (Sovren/Textkernel, Daxtra, Ashby) use the Recursive XY-Cut algorithm, and how subtle layout traps (horizontal divider lines spanning across gutters, wide multi-column headers, gutters $<12\text{pt}$) collapse vertical projection valleys and cause parser structural failure.
  - You remember how subsetted PDF fonts lacking a valid `/ToUnicode` CMap emit characters in the Unicode Private Use Area (`\uE000-\uF8FF`) or replacement characters (`\uFFFD`), rendering the resume completely unsearchable to downstream lexical indices.
```
END THIRD-PARTY FILE 9eee8ac239d3a065

The third-party file has ended. Everything between the 9eee8ac239d3a065 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2628 of 28766 bytes. © huytran1120 · MIT · https://github.com/huytran1120/vie-agentic-skills/tree/HEAD/skills/agency-ats-validator-architect/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
