Skip to content

keyanfeili/bto-hr

v4.0.4

Create BTO Word CVs, rank candidates against job descriptions, and organise Trello Talent Pool cards.

BTO HR

Convert an original PDF or Word CV into an editable BTO Word document in English, using the bundled R.R./A.F.R. master, Century Gothic typography and native square bullet lists.

Version 4.0.4 applies 5 pt after-spacing to every IT SKILLS bullet, including category-final bullets, using the same visible-gap logic as experience lists. IT SKILLS consolidates repeated or overlapping descriptions where meaning is preserved; distinct technologies, versions and proficiency qualifiers remain. Repetition between experience and IT SKILLS is intentional. Experience spacing remains 5 pt except for the final bullet of each role (0 pt).

Version 4.0.2 preserves existing Excel headers, uses plain experience ranges, and validates the Excel projection before writing. Context-first criteria keep recommendations aligned with scores; a content-addressed cache reuses reconciled evidence, and a range planner prepares idempotent workbook updates with conflict checks. Direct range writes require a connected Excel session; the planner does not provide authentication or cloud access. It bundles BTO CV conversion, score for JD-specific rankings and shared Excel shortlists, and trello for Trello cards without file uploads. It also requires every source or user-approved skill to remain in IT SKILLS even when repeated under experience, with an inventory check before delivery. It retains the streamlined build-and-verify command and the measured Word layout: experience bullets have 5 pt after-spacing except the final bullet in each role, and all IT skills bullets have 5 pt after-spacing; other lists keep their existing spacing. Each “Main responsibilities:” label keeps its 1.5-line spacing. Wording stays unchanged unless translation or necessary cleanup is required. Candidate facts and documents are never repository fixtures.

Install and update

Use a local Codex environment with plugin support, Python 3 and Git. The repository's current access settings determine whether a GitHub invitation is necessary; an install link does not grant repository access.

Copy this message into a local Codex chat:

Install BTO CV from https://github.com/KeyanFEILI/BTO-CV.git. Check whether bto-hr@bto-cv-marketplace is already installed. If not, register the marketplace with codex plugin marketplace add https://github.com/KeyanFEILI/BTO-CV.git --ref main, then run codex plugin add bto-hr@bto-cv-marketplace. Verify that it is installed and enabled, preserve any standalone skill until the plugin is verified, and tell me when to start a new chat. Do not ask for passwords or tokens.

After installation, start a new chat and select BTO HR, attach the original CV and ask for a BTO Word conversion. Install BTO CV opens the install screen after marketplace registration where supported.

To update:

Update bto-hr@bto-cv-marketplace from its registered source. Run codex plugin marketplace upgrade bto-cv-marketplace, inspect the installed version, and use the supported plugin update or reinstall flow if needed. Verify the result without creating a second copy and tell me when to start a new chat.

Conversion uses the template and generator from the same installed release. It does not fetch a template from GitHub or need network access. A failed update check does not prevent conversion with the verified installed pair. Start a new chat after an update; an existing chat does not hot-reload instructions.

Conversion contract

  • English unless another language is requested. Faithful translation; no stylistic rewrite of clear source text, stronger verbs or invented technical scope.
  • Experience dates use MM/YYYY when months exist; year-only dates stay years. No invented days or months.
  • Education and certifications put dates last: Qualification or school, supplied location | dates. Missing degree titles remain missing; user-approved education wording is preserved.
  • IT skills have at most four coherent groups without losing tools or methods.
  • Languages use Native, Fluent or Professional according to the BTO display convention. All languages remain, and exam names, scores, status and dates move to certifications.
  • Responsibilities retain distinct projects, combine only related fragments, and avoid redundant "Objective" labels and duplicate bullets.

The complete content contract is in content.md; the measured layout is in format.md. The agent extracts and reconciles source content once, prepares private UTF-8 JSON, validates it, builds the document, verifies it and inspects its rendered pages. JSON is an internal step, not a user requirement.

Candidate scoring and shared Excel

Use $score with one or more JDs and multiple CVs. Each JD receives a separate, context-led ranking with 95 role-fit points plus up to 5 employer-bonus points. Chat shows candidates scoring >=60/100 with rank, match percentage, name, city/country, and a brief fit/gap description. Phone and email appear in chat only at >=80/100. Lower-scoring candidates are assessed privately and shown only when explicitly requested.

Each ranking also updates the configured shared Excel workbook when accessible. Final scores >=80/100 qualify for automatic export; explicit user selection can override this for named candidates without changing their scores. Match the JD to an existing role sheet. Create a sheet for an unrelated role using the JD title and existing headers. Repeated candidates update their existing row, missing details stay blank, and colleague-managed fields are preserved. Existing headers are never added, renamed or reordered; fields without a column stay in private notes. Rank remains chat-only and is not written to Excel. XP uses plain years or ranges. Language flags, batch labels and score arithmetic are not appended to workbook descriptions or new columns. No background process or workbook access is installed.

Configure the workbook with SCORE_WORKBOOK_URL or a private, ignored skills/score/references/workbook.local.json containing {"url": "your sharing link"}. Colleagues need their own existing workbook access. The agent verifies writes and reports sign-in/access blockers; it never replaces the shared file with a local copy. See the shared-workbook workflow.

Trello Talent Pool

Use $trello with candidate CVs to create or update cards on the BTO Talent Pool board. It checks for duplicates, fills factual profile fields, chooses the appropriate role list and applies one supported seniority label. Client opportunity copies require a user request and retain the pool original.

File uploads are excluded: the skill does not upload originals or BTO CVs, and card creation does not require a document conversion. Existing attachments and colleague notes are preserved. BTO CV conversion remains available separately. Users need an authenticated Trello connection and access to the board; installing the skill does not grant access or create cards. See the Trello skill for the card conventions.

Verification and maintenance

Run these from the repository with Python 3:

python -m unittest discover -s tests -v
python -m unittest discover -s skills/score/tests -v
python skills/bto-cv/scripts/build_docx.py skills/bto-cv/references/input-example.json --check

For a finished, source-reconciled candidate JSON, build and verify in one process:

python skills/bto-cv/scripts/convert.py candidate.json BTO_CV_A.E.docx

The command reports build/verification times without candidate content. It does not render the document or replace source reconciliation and visual review. Reuse extracted text and JSON on revisions. Skip a separate pre-build --check: build already validates.

Standalone commands remain available for draft validation and diagnostics:

python skills/bto-cv/scripts/build_docx.py candidate.json --check
python skills/bto-cv/scripts/build_docx.py candidate.json BTO_CV_A.E.docx
python skills/bto-cv/scripts/verify_docx.py candidate.json BTO_CV_A.E.docx

Tests run in GitHub Actions on Windows and Linux. Checks cover date normalization, source precision, qualification date placement, language/exam retention, category limits, duplicate labels, editable content, native numbering, unchanged design parts and overwrite protection. They cannot prove that a translation faithfully represents an unseen CV. Source reconciliation and inspection of every rendered page are separate required checks. Prefer Word PDF export on Windows when available; use a supported renderer elsewhere. If rendering is unavailable, disclose that limitation.

The Word master is skills/bto-cv/assets/BTO_CV_Template.docx, paired with skills/bto-cv/scripts/build_docx.py. Only word/document.xml changes in generated documents. The anonymized master banner, styles, numbering and page settings remain intact. Do not force page counts or shrink fonts. Rendered pagination depends on content, fonts and software.

For releases, bump plugin.json, keep instructions, examples and tests consistent, and run the full suite. Never commit candidate originals, approved candidate CVs, extracted text or reconciliation data. Use fictional examples such as sample-cv.txt. The current onboarding PDFs are BTO HR Team Setup and BTO HR Owner Checklist. They cover all three skills, migration, private Excel setup and Trello without uploads. Rebuild them with python docs/build_guides.py (ReportLab required), then render and inspect every page before publishing. The refreshed repository manifest remains the installation-version authority.

Automatic updater

The BTO-only SessionStart hook checks the registered marketplace at startup/resume at most once per day, retries failures after an hour, respects disabled installations and prevents overlapping checks. Review and trust it through the supported hook-review interface. Installation alone does not trust it. The hook never reads candidate documents.

Python 3, Git and a plugin-capable Codex CLI must be available. BTO_CODEX_BIN supports an explicit CLI path. Git access must work non-interactively; credentials are never requested or printed by the hook. To diagnose, run the installed hooks/update.py --force --check. current or updated confirms success; failed needs attention. A changed hook definition may require renewed review. New chats are required after package updates.

Maintainer: Keyan FEILI. Colleagues may generate and edit their own CVs; shared package changes are coordinated with Keyan. This convention is not an access-control mechanism.

Upgrade from BTO CV

Version 4.0.0 renames the plugin to bto-hr (display name BTO HR) and the Talent Pool skill to trello. The repository URL and marketplace registration remain unchanged. Refresh the marketplace, install bto-hr@bto-cv-marketplace, verify its three skills, then remove the old bto-cv@bto-cv-marketplace install to avoid duplicates. Preserve private workbook configuration before removal and restore it in the new Score installation. Start a new chat after migration.