🎯 KnowMe CareerForge

KnowMe CareerForge is an industrial-grade, agent-native resume engineering skill for Claude Code, Cursor, Codex, Windsurf, and Gemini CLI.

Traditional AI resume tools treat resume writing as a superficial text-generation task: feed a prompt to an LLM, get a block of Markdown, and convert it through black-box tools into a fragile, hallucination-prone PDF.

KnowMe CareerForge fundamentally rethinks this paradigm into a structured, dual-engine system:

knowme-careerforge-skill
          │
          ▼
   KnowMe CareerForge
          │
    ┌─────┴─────┐
    ▼           ▼
  KnowMe     CareerForge
    │           │
Self Discovery  Tailored Career Story
& Evidence      & Engineering Delivery

• KnowMe (Self-Discovery & Evidence Engine): Helps candidates discover who they are, organize their supplied career experience and supporting material, and map their true competitive strengths.
• CareerForge (Career Positioning & Resume Engineering): Translates genuine strengths into targeted positioning for specific job opportunities, tailoring high-impact content inside an HTML Intermediate Working Canvas with Design Tokens, and delivering deterministic, pixel-perfect PDFs via Playwright.

"The goal is not to make the candidate look better than they are. The goal is to make their real strengths visible to the right opportunity."

WRONG DIRECTION (Generic AI Hallucination):
JD ──> Keyword Stuffing ──> AI Guessing ──> Superficial Fluff ──> Inflated Claims (Fragile in Interviews)

RIGHT DIRECTION (KnowMe CareerForge):
Real Experience ──> Grounded Evidence ──> True Strengths ──> Job Match ──> Precise Engineering & Narrative

You can install and use KnowMe CareerForge via CLI (Zero Clone) or directly through Agent-Native Manifests:

Run directly with npx (no clone required):

# Go to your project directory
cd /path/to/your/project

# Install for your preferred AI assistant
npx knowme-careerforge-skill init --ai cursor    # Cursor (.cursor/rules/)
npx knowme-careerforge-skill init --ai claude    # Claude Code (~/.claude/skills/)
npx knowme-careerforge-skill init --ai codex     # Codex CLI (~/.codex/skills/)
npx knowme-careerforge-skill init --ai windsurf  # Windsurf (.windsurfrules)
npx knowme-careerforge-skill init --ai gemini    # Gemini CLI (~/.gemini/skills/)
npx knowme-careerforge-skill init --ai opencode  # OpenCode (.opencode/skills/)
npx knowme-careerforge-skill init --all          # All supported assistants

Or install globally:

npm install -g knowme-careerforge-skill
knowme init --ai cursor
knowme list

Cursor/Windsurf reference a project-local .knowme/skills/knowme-careerforge/ runtime; Gemini configuration points to its sibling runtime directory. Each routes to the same SKILL.md workflow. File installation does not certify host discovery or behavior. Copying a prompt alone is insufficient. Rerun init after relocating an installation to refresh entry paths.

The host Agent organizes user descriptions, existing resume material and explicitly supplied supporting evidence. Repository-to-resume extraction is not supported. A target role starts intake; a JD is optional. Without candidate material, ask and wait rather than generating an example.

Draft retains incomplete information, Master preserves supplied facts, and Variant records its source Master hash for a target role. Missing values stay omitted/null; sample people, default honors and invented metrics never fill gaps. See the artifact and acceptance contract.

Each forge invocation writes snapshots, Master, Variant, canvas, QA and manifest to workspace/runs/<runId>/. Only an accepted fresh PDF is published. Failed manifests never identify an old output as delivery. Optional --output and --html-output create verified copies.

Checks run in print mode across every page, then parse the final PDF's page dimensions and extracted text. PASS means current checks passed; FAIL means a check failed; UNVERIFIED means inspection could not complete; DRAFT means draft preparation only. Automated checks do not certify factual truth or every ATS.

Prepare dependencies in the installed runtime as instructed by init (npm ci --omit=dev with a lockfile, otherwise npm install --omit=dev), then run node scripts/rendering/browser-engine.js --check-runtime. Python 3.9+, Node.js 22.13+ and Chromium are required. READY is runtime readiness, not resume acceptance. Deliver one current PDF and editable HTML by default; forge.py --summary keeps stdout concise while retaining internal snapshots and diagnostics.

All visual parameters are concentrated in :root variables inside the current run’s resume.html:

# 1. One-shot resume engineering pipeline (user facts -> canvas -> QA -> PDF)
knowme forge --profile-json candidate.json --role "AI Agent Engineer" --template modern --quiet

# 2. Search best template for target role (hybrid engine)
knowme search --role "AI Agent Engineer" --engine hybrid

# 3. Prepare an incomplete draft without PDF delivery
knowme forge --profile-json draft.json --draft

# 4. Validate working canvas layout & ATS compliance
knowme validate /path/to/current-run/resume.html --json

# 5. Render deterministic pixel-perfect PDF
knowme render --input workspace/resume.html --output output/resume.pdf

# 6. Build & view static HTML Template Gallery
knowme gallery

npm test
# Or:
python3 scripts/build/run-all-tests.py

This package is ready to be built, tested, and published to the NPM Registry:

# 1. Automated release preparation & verification (e.g. patch/minor/major)
npm run release -- <version>

# 2. Publish to public NPM registry
npm publish --access public

See the full NPM Publishing & Update Guide for step-by-step release instructions.

This project is licensed under the MIT License - see the LICENSE file for details.