apex-generate-competency-mapping
Purpose
This skill maps the candidate’s job history to a provided SKILLS_TAXONOMY and outputs:
- Skills used in each role with relevance scores (3/2/1)
- Aggregated total experience per skill (years/months), avoiding double-counting overlaps
- A skill type/category for each skill (from SKILLS_TAXONOMY when available)
This output is commonly useful for IOM/Oracle Fusion Cloud Recruiting systems and internal consistency checks.
Shared definitions
Apply the expert lens, collaboration rules, guardrails, quality loop protocol, guiding principles, and error handling patterns defined in apex-guardrails.
Inputs
Required:
USER_JOB_HISTORY_TEXT (must include role dates)
SKILLS_TAXONOMY (the authoritative list of skills; do not invent new skills)
Optional:
JOB_DESCRIPTION_TEXT (to interpret relevance, but relevance must still be grounded in role evidence)
Output format
Divide the document into two sections with exactly these headings:
## Job title and skills
- For each job, output two lines:
- Job Title:
Job Title — Organization — Dates (use placeholders if missing).
- Skills: a comma‑separated list oin descending relevance, formatted as
SkillName (3) / SkillName (2) / SkillName (1)
- Insert a blank line between each job entry.
## Total years of experiences per skills with Skill Type
- For each unique skill with score ≥1 in any job, output exactly three lines:
- Skills:
<SkillName>
- Total years of experiences:
<X years Y months [Z days]> (use placeholders if dates are missing)
- Skill Type:
<CategoryName> (choose from Adaptation, Communication, Hard Skill, Leadership, Persuasion, Problem Solving, Soft Skill, Teamwork, Time Management).
- Insert a blank line between each skill entry.
Do not add any other headings or narrative text.
Relevance scoring rubric
- Assign per-role relevance scores based on explicit evidence in that role:
- 3 = Core skill central to the role; repeatedly used; key outputs depend on it
- 2 = Frequently used skill; important but not the primary focus.
- 1 = Occasional skill used; supporting skill.
- 0 = Not used (do not list).
- Determine relevance based on explicit evidence in the job description
and the candidate’s role description; if uncertain, err on the side
of lower scores.
Total experience calculation rules
- Use role dates to compute durations (years/months).
- Do not double-count overlapping calendar time:
- If two roles overlap, a calendar month counts once per skill even if the skill appears in both roles.
- If dates are incomplete or missing:
- Use placeholders for totals (e.g.,
[Confirm dates to calculate total]) rather than guessing.
Skill Type / Category rules
- Use the category/type provided in SKILLS_TAXONOMY when available.
- If SKILLS_TAXONOMY does not include categories, use one of:
Adaptation; Communication; Hard Skill; Leadership; Persuasion; Problem Solving; Soft Skill; Teamwork; Time Management.
Rules
- Only list skills present in SKILLS_TAXONOMY.
- Do not invent dates or durations.
- Do not include commentary outside the two required sections.
Recursive self-evaluation (internal only; do not print)
Apply the recursive self-evaluation loop protocol from apex-guardrails.
Domain-specific checks for this skill: verify relevance scores
reflect actual role duties, format follows the two-section structure
precisely, and no double-counting of overlapping timeframes.
Steps
- Parse USER_JOB_HISTORY_TEXT to extract roles with their timeframes and
responsibilities/achievements.
- For each role:
- Identify which taxonomy skills are explicitly evidenced in duties/achievements.
- Assign relevance scores (3/2/1) and list the skills.
- Aggregate totals
- For each skill, sum role durations where that skill appears (score ≥1), avoiding double counting overlaps.
- Assign Skill Type per skill using SKILLS_TAXONOMY when possible, if SKILLS_TAXONOMY does not include categories, use one of:
Adaptation; Communication; Hard Skill; Leadership; Persuasion; Problem Solving; Soft Skill; Teamwork; Time Management.
- Output in the required two-section format only.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: yutsukioka-un-job-application-helper-apex-generate-competenc3description: apex-generate-competency-mapping4---56# apex-generate-competency-mapping78## Purpose910This skill maps the candidate’s job history to a provided `SKILLS_TAXONOMY` and outputs:111) Skills used in each role with relevance scores (3/2/1)122) Aggregated total experience per skill (years/months), avoiding double-counting overlaps133) A skill type/category for each skill (from SKILLS_TAXONOMY when available)1415This output is commonly useful for IOM/Oracle Fusion Cloud Recruiting systems and internal consistency checks.1617## Shared definitions1819Apply the expert lens, collaboration rules, guardrails, quality loop protocol, guiding principles, and error handling patterns defined in `apex-guardrails`.2021## Inputs2223Required:24- `USER_JOB_HISTORY_TEXT` (must include role dates)25- `SKILLS_TAXONOMY` (the authoritative list of skills; do not invent new skills)2627Optional:28- `JOB_DESCRIPTION_TEXT` (to interpret relevance, but relevance must still be grounded in role evidence)2930## Output format3132Divide the document into two sections with exactly these headings:33341. `## Job title and skills`35 - For each job, output two lines:36 * **Job Title:** `Job Title — Organization — Dates` (use placeholders if missing).37 * **Skills:** a comma‑separated list oin descending relevance, formatted as `SkillName (3)` / `SkillName (2)` / `SkillName (1)`38 - Insert a blank line between each job entry.39402. `## Total years of experiences per skills with Skill Type`41 - For each unique skill with score ≥1 in any job, output exactly three lines:42 * **Skills:** `<SkillName>`43 * **Total years of experiences:** `<X years Y months [Z days]>` (use placeholders if dates are missing)44 * **Skill Type:** `<CategoryName>` (choose from Adaptation, Communication, Hard Skill, Leadership, Persuasion, Problem Solving, Soft Skill, Teamwork, Time Management).45 - Insert a blank line between each skill entry.4647Do not add any other headings or narrative text.4849## Relevance scoring rubric5051- Assign per-role relevance scores based on explicit evidence in that role:52 - 3 = Core skill central to the role; repeatedly used; key outputs depend on it53 - 2 = Frequently used skill; important but not the primary focus.54 - 1 = Occasional skill used; supporting skill.55 - 0 = Not used (do not list).56- Determine relevance based on explicit evidence in the job description57 and the candidate’s role description; if uncertain, err on the side58 of lower scores.5960## Total experience calculation rules6162- Use role dates to compute durations (years/months).63- Do not double-count overlapping calendar time:64 - If two roles overlap, a calendar month counts once per skill even if the skill appears in both roles.65- If dates are incomplete or missing:66 - Use placeholders for totals (e.g., `[Confirm dates to calculate total]`) rather than guessing.676869## Skill Type / Category rules7071- Use the category/type provided in SKILLS_TAXONOMY when available.72- If SKILLS_TAXONOMY does not include categories, use one of:73 Adaptation; Communication; Hard Skill; Leadership; Persuasion; Problem Solving; Soft Skill; Teamwork; Time Management.7475## Rules7677- Only list skills present in SKILLS_TAXONOMY.78- Do not invent dates or durations.79- Do not include commentary outside the two required sections.8081## Recursive self-evaluation (internal only; do not print)8283Apply the recursive self-evaluation loop protocol from `apex-guardrails`.8485**Domain-specific checks for this skill:** verify relevance scores86reflect actual role duties, format follows the two-section structure87precisely, and no double-counting of overlapping timeframes.8889## Steps90911. Parse USER_JOB_HISTORY_TEXT to extract roles with their timeframes and92 responsibilities/achievements.932. For each role:94 - Identify which taxonomy skills are explicitly evidenced in duties/achievements.95 - Assign relevance scores (3/2/1) and list the skills.963. Aggregate totals 97 - For each skill, sum role durations where that skill appears (score ≥1), avoiding double counting overlaps.984. Assign Skill Type per skill using SKILLS_TAXONOMY when possible, if SKILLS_TAXONOMY does not include categories, use one of:99 Adaptation; Communication; Hard Skill; Leadership; Persuasion; Problem Solving; Soft Skill; Teamwork; Time Management.1005. Output in the required two-section format only.101102---103> Converted and distributed by [TomeVault](https://tomevault.io/claim/yutsukioka) — claim your Tome and manage your conversions.104<!-- tomevault:4.0:skill_md:2026-04-14 -->