# Setup > Initialize JobOps workspace - configure output directories, install templates, and optionally migrate legacy files - Skill: `reggiechan74/setup` (Agent Skill) - Install (CLI): `npx skillmds@latest add reggiechan74/setup` - Raw SKILL.md: https://api.skillmd.com/api/skills/reggiechan74/setup/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: reggiechan74 (https://skillmd.com/u/reggiechan74) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/reggiechan74/setup --- # JobOps Workspace Setup This skill initializes or reconfigures a JobOps workspace. It writes a single user-owned config file at `.jobops/config.json`, creates the output directory tree, installs templates from the plugin into the workspace, updates `.gitignore`, and offers optional career-history import and legacy-file migration. **Flags:** - `--reconfigure` — re-run setup against an existing workspace; prompts before overwriting anything. - `--skip-migration` — skip the legacy-file migration step (Step 9) unconditionally. - `--skip-history` — skip the optional career-history import (Step 8). --- ## Step 1: Welcome and existing-config check If `.jobops/config.json` already exists, read it and present three choices: 1. **Reconfigure all** — walk the full interview; overwrite at the end. 2. **Reconfigure specific sections** — directories only / preferences only / candidate (contact details) only / templates only / migration only. 3. **Exit** — leave everything as-is. If `--reconfigure` was passed, skip the prompt and go straight to option 1. If no config exists, proceed to Step 2. --- ## Step 2: Directory interview Walk the user through every path in `config.directories`. Present the default, a one-sentence purpose, and allow inline editing. Paths are normalized (strip trailing slash, resolve `~`, keep as relative-to-workspace form that starts with `./`). | Key | Default | Purpose | |---|---|---| | `resume_source` | `./ResumeSourceFolder` | Master HAM-Z career data (user-maintained input) | | `job_postings` | `./Job_Postings` | Target job descriptions (user-maintained input) | | `applications_root` | `./Applications` | Per-application output tree (one folder per application) | | `company_intelligence` | `./Company_Intelligence` | OSINT output tree (shared across applications to same company) | | `career_analysis` | `./Career_Analysis` | Career-level outputs (idealjob, change-one-thing, comparejobs) | | `crisis_management` | `./Crisis_Management` | Crisis-skill outputs (severance, non-compete, etc.) | | `tailored_cv` | `./Tailored_CV` | Base resume library for revise-first `/jobops:buildresume` (one per role family) | | `application_tracker` | `./Applications/tracker.yaml` | Application status tracker maintained by `/jobops:dashboard` (one YAML file, not a folder) | > `application_tracker` is a **file** path, not a directory — Step 3 must not `mkdir` it. Its parent directory (`applications_root`) is already created, so no extra action is needed. For each path: validate the parent is writable. If not, surface the specific error and allow the user to correct it before continuing. --- ## Step 3: Create directories For each confirmed path, run `mkdir -p `. Report each as **created** (newly made) or **exists** (already present). Do not fail if a path already exists. > Skip `application_tracker` — it is a file path, not a directory; its parent (`applications_root`) is already created by this loop. Also `mkdir -p .jobops .jobops/templates/default .jobops/templates/custom`. --- ## Step 4: Preferences interview Ask in order: 1. **Cultural profile** — enum `canadian` | `american`. Default `canadian`. Controls resume voice and spelling conventions. 2. **Default jurisdiction** — ISO 3166-2 code (e.g., `CA-ON`, `US-CA`). Default `CA-ON`. Used by crisis skills; they accept `--jurisdiction=` to override per-invocation. 3. **Cover letter mode** — enum `retrospective` | `forward`. Default `retrospective`. Controls how `/jobops:coverletter` writes the letter. `retrospective` maps the job's requirements to what the candidate has already done. `forward` proposes what the candidate would do in the first 90 days, tying each action to a real problem the role faces and to past work that proves the candidate can do it; it runs a short interview each time it is used. Override per-invocation with `/jobops:coverletter --mode=retrospective|forward`. Do **not** ask for `default_currency` here — that is owned by `/jobops-ic:setup` (see Step 4 of that flow). --- ## Step 4b: Candidate contact details Collect the contact fields that populate the resume and cover-letter headers. These live in `config.candidate` so every document renders the same header and no field is ever fused into another (the cover-letter header had no phone slot historically, which produced fused `(xxx) xxx-xxxxemail@example.com` artifacts; the dedicated field fixes this). Ask for each (any may be left blank; blank fields are omitted from the header with their separator): 1. **Full name** — e.g., `Jane Doe` 2. **Credentials / post-nominals** — e.g., `CFA, FRICS` (blank if none) 3. **Location** — e.g., `Toronto, ON` 4. **Phone** — e.g., `(555) 555-1234` (its own header field; never concatenated onto the email) 5. **Email** — e.g., `jane.doe@example.com` 6. **LinkedIn** — handle or URL, e.g., `linkedin.com/in/janedoe` 7. **GitHub** — handle or URL, e.g., `github.com/janedoe` (blank if none) If the user prefers to keep contact details out of config, write the block with empty strings; the resume and cover-letter skills surface the gap rather than invent a value. --- ## Step 5: Template installation Copy the plugin's bundled templates into the workspace: ```bash cp ${CLAUDE_PLUGIN_ROOT}/templates/*.md .jobops/templates/default/ 2>/dev/null || true cp -r ${CLAUDE_PLUGIN_ROOT}/templates/latex .jobops/templates/default/ ``` Report the count of files copied. Expected count after this task runs: 3 markdown templates (`assessment_rubric_framework.md`, `evidence_verification_framework.md`, `assessment_report_structure.md`) plus 1 latex/ subdirectory (`preamble.base.tex.template`, `preamble.resume.tex.template`, `preamble.coverletter.tex.template`, `preamble.document.tex.template`, `jobops-filter.lua`, `config.json`, `README.md`). If the glob fails in the current execution context (no files matched), fall back to: ```bash find ${CLAUDE_PLUGIN_ROOT}/templates -maxdepth 1 -type f -exec cp {} .jobops/templates/default/ \; cp -r ${CLAUDE_PLUGIN_ROOT}/templates/latex .jobops/templates/default/ ``` Do not touch `.jobops/templates/custom/` — it is user-owned. --- ## Step 6: Write `.jobops/config.json` Emit the full schema below with the values gathered in Steps 2 and 4. `migration.completed` starts as `false` so Step 9 runs on first setup. ```json { "version": "2.0", "directories": { "resume_source": "", "job_postings": "", "applications_root": "", "company_intelligence": "", "career_analysis": "", "crisis_management": "", "tailored_cv": "", "application_tracker": "" }, "preferences": { "cultural_profile": "", "default_jurisdiction": "", "cover_letter_mode": "" }, "candidate": { "name": "", "credentials": "", "location": "", "phone": "", "email": "", "linkedin": "", "github": "" }, "templates": { "base_dir": "./.jobops/templates", "active": { "assessment_rubric_framework": "default", "evidence_verification_framework": "default", "assessment_report_structure": "default", "latex_config": "default" } }, "migration": { "completed": false, "completed_at": null, "files_moved": 0 } } ``` Write atomically: write to `.jobops/config.json.tmp`, then `mv` over the final name. --- ## Step 7: Gitignore update Show the user the JobOps block that will be appended to `.gitignore`: ``` # JobOps workspace .jobops/ Applications/ Company_Intelligence/ Career_Analysis/ Crisis_Management/ ``` (If the user customized any of the directory names in Step 2, substitute those paths in the block.) Offer three choices: 1. **Append as shown** — add the block to the end of `.gitignore`. 2. **Edit inline** — let the user modify the block before appending. 3. **Skip** — do not modify `.gitignore`. If `.gitignore` does not exist, create it. If the block (detected by the `# JobOps workspace` marker line) already exists, replace it in place rather than appending a second copy. --- ## Step 8: Optional career-history import Only offer this step if `--skip-history` was not passed and the `resume_source` directory is empty or contains fewer than 3 files. Prompt: "Do you have an existing resume to import as the basis for your HAM-Z career inventory? (yes/no)" If yes, accept a path to a `.pdf`, `.docx`, `.txt`, or `.md` file. Extract text, then populate: - `{resume_source}/Experience/_.md` — one file per role - `{resume_source}/CareerHighlights/highlights.md` - `{resume_source}/Technology/stack.md` - `{resume_source}/Preferences/preferences.md` - `{resume_source}/Vision.md` — stub, to be filled in manually After population, flag any entries that lack metrics or hard skills so the user knows where to focus subsequent manual enrichment. --- ## Step 9: Optional legacy migration Skip this step if `--skip-migration` was passed OR `migration.completed` is already `true` in the config being reconfigured. Scan for legacy folders at the workspace root and subfolders named: - `OutputResumes/` - `Briefing_Notes/` - `Scoring_Rubrics/` - `Intelligence_Reports/` If all four are absent or empty, skip this step silently (and still set `migration.completed = true`). Otherwise run: **9a. Dry-run parse.** For each file in the legacy folders, attempt to parse `{Company}_{Role}_{YYYYMMDD}` from the filename using the following patterns (tried in order): 1. `^([A-Za-z0-9]+)_([A-Za-z0-9]+)_(\d{8})\.md$` 2. `^(?:Step\d+_)?(?:Draft_|Provenance_Analysis_|Final_Resume_)?([A-Za-z0-9]+)_([A-Za-z0-9]+)_(\d{8})\.md$` 3. `^Rubric_([A-Za-z0-9]+)_([A-Za-z0-9]+)_(\d{8})\.md$` For each match, compose a planned destination: - `OutputResumes/Step1_*` and `Step2_*` and `Step3_*` → `{applications_root}/{Company}_{Role}_{Date}/resume/.md` - `OutputResumes/Cover_Letter_*` → `{applications_root}/{Company}_{Role}_{Date}/cover-letter/cover_letter.md` - `Scoring_Rubrics/Rubric_*` → `{applications_root}/{Company}_{Role}_{Date}/assessment/rubric.md` - `Briefing_Notes/*` → `{applications_root}/{Company}_{Role}_{Date}/interview/briefing.md` - `Intelligence_Reports/_*` → `{company_intelligence}/{Company}/.md` (parse the agent name from the filename segment between Company and Date) **9b. Preview.** Print the planned moves grouped by target app folder. List unresolved files (no regex match) in a separate "manual" group. **9c. User-editable mapping.** Offer three options: 1. **Execute as shown** — proceed with the preview. 2. **Edit mapping** — drop into an inline editor where the user can reassign specific files to different application folders or mark them as "skip". 3. **Cancel** — leave everything in place. **9d. Execute.** For each confirmed move: - If the file is tracked in git, use `git mv ` (preserves history). - Otherwise use plain `mv`. - Create any missing destination parent folders first. **9e. Update config.** Set: - `migration.completed = true` - `migration.completed_at = ` - `migration.files_moved = ` Unresolved files stay in place; the user handles them manually. --- ## Step 10: Summary and next steps Print: 1. What was configured (each path + confirm/created/exists). 2. What was installed (template count). 3. Whether career history was imported (and how many files). 4. Whether migration ran (and how many files moved). 5. Recommended next steps: - Drop a job posting into `{job_postings}/` named `{Company}_{Role}_{YYYYMMDD}.md`. - Run `/jobops:buildresume ` to produce a tailored resume. - Run `/jobops:osint ` to gather company intelligence. - If you are an independent contractor, run `/jobops-ic:setup` to enable IC features. Exit.