resumebuilder-tools 1.0.0__tar.gz

resumebuilder_tools-1.0.0/.agents/install-block.md

@@ -0,0 +1,140 @@
+# The canonical install block
+
+One install story, one wording. `README.md`, `.changeset/*`, and every page
+under `docs/` must say **this** and nothing else. Change it here first, then
+propagate.
+
+## Managed installs first
+
+Lead with installs that update themselves. Fall back to skills.sh, labelled
+"manual updates", only for agents that have no such install. Call a route
+managed only if it updates without the user running a command. Put any one-time
+opt-in beside its install command. Never promise "instant".
+
+Claude Code installs from its official marketplace. Every other managed route
+installs from this repo's own marketplace, `.claude-plugin/marketplace.json`
+and `.claude-plugin/plugin.json`. Those routes reinstall only when the `version`
+in `plugin.json` changes. The Release workflow runs `npm run version`, which
+copies that field from `package.json`, so users get a release when the "chore:
+version skills" PR merges.
+
+| Agent         | Route                            | Updates itself?                                                  |
+|-------------- |----------------------------------|------------------------------------------------------------------|
+| Claude Code   | `claude plugin install`          | Yes, by default                                                  |
+| Codex         | `@resumebuilder` marketplace     | Yes, at startup, by default                                      |
+| Copilot CLI   | `@resumebuilder` marketplace     | Yes, after a one-time `autoUpdate: true`                         |
+| VS Code       | Chat: Install Plugin From Source | Yes, daily, by default                                           |
+| Gemini CLI    | `gemini skills install` (copies) | No. Re-run to update.                                            |
+| Everyone else | skills.sh                        | No. Run `npx skills update`, and re-run `add` for new skills     |
+
+## Claude Code
+
+<canonical-block name="claude-code">
+
+```bash
+claude plugin install resumebuilder-skills
+```
+
+Updates itself by default.
+
+</canonical-block>
+
+## Codex
+
+<canonical-block name="codex">
+
+```bash
+codex plugin marketplace add S-Dawn/ResumeBuilder
+codex plugin add resumebuilder-skills@resumebuilder
+```
+
+Updates itself at startup.
+
+</canonical-block>
+
+## GitHub Copilot (CLI and VS Code)
+
+Use the marketplace. Copilot has deprecated direct repo installs, and they
+can't auto-update. The `extraKnownMarketplaces` entry follows the documented
+schema.
+
+<canonical-block name="copilot">
+
+```bash
+copilot plugin marketplace add S-Dawn/ResumeBuilder
+copilot plugin install resumebuilder-skills@resumebuilder
+```
+
+Then, once, add to `~/.copilot/settings.json`:
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "resumebuilder": { "source": { "source": "github", "repo": "S-Dawn/ResumeBuilder" }, "autoUpdate": true }
+  }
+}
+```
+
+In VS Code, run **Chat: Install Plugin From Source** and enter
+`https://github.com/S-Dawn/ResumeBuilder`. It updates daily.
+
+</canonical-block>
+
+## Gemini CLI
+
+Gemini doesn't read `.claude-plugin`, and `--path` takes one folder. One install
+per folder gives the promoted set.
+
+<canonical-block name="gemini">
+
+```bash
+gemini skills install https://github.com/S-Dawn/ResumeBuilder.git --path skills/
+```
+
+Re-run to update.
+
+</canonical-block>
+
+## Every other agent, or editable files (skills.sh)
+
+`-a` preselects the agent. Prefer skills.sh to an agent's own repo installer.
+
+<canonical-block name="other-agents">
+
+```bash
+npx skills@latest add S-Dawn/ResumeBuilder -a <agent>  # cursor, opencode, devin, windsurf, amp, pi; omit -a to choose
+```
+
+When the installer asks which skills to take, include
+`setup-resumebuilder-skills`. To update, run `npx skills@latest update`, and
+re-run `add` to pick up new skills.
+
+</canonical-block>
+
+<canonical-block name="skills-sh-one-skill">
+
+```bash
+npx skills@latest add S-Dawn/ResumeBuilder --skill=<name>
+```
+
+```bash
+npx skills@latest update <name>
+```
+
+</canonical-block>
+
+`skills@latest` is the pinned spelling everywhere.
+
+## The two routes are exclusive
+
+The plugin is a managed, read-only bundle you subscribe to. skills.sh writes
+files you own and edit. Installing both leaves the user with every skill twice:
+always say "pick one".
+
+## Step 2: Run /setup-resumebuilder-skills
+
+In your agent, run it once per repo. It will:
+
+- Ask where your canonical profile lives (`profile/`)
+- Ask where resume drafts should be saved (`generated/`)
+- Ask which ATS validation you want (WeasyPrint, pypdf, or both)

resumebuilder_tools-1.0.0/.changeset/README.md

@@ -0,0 +1,8 @@
+{
+  "changelog": "@changesets/changelog-github",
+  "repo": "https://github.com/S-Dawn/ResumeBuilder",
+  "access": "public",
+  "baseBranches": ["main"],
+  "updateInternalDependencies": "always",
+  "ignore": []
+}

resumebuilder_tools-1.0.0/.changeset/config.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": "@changesets/changelog-github",
+  "repo": "https://github.com/S-Dawn/ResumeBuilder",
+  "access": "public",
+  "baseBranches": ["main"],
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

resumebuilder_tools-1.0.0/.claude-plugin/marketplace.json

@@ -0,0 +1,23 @@
+{
+  "name": "resumebuilder",
+  "owner": {
+    "name": "Subham Dawn",
+    "url": "https://github.com/S-Dawn"
+  },
+  "description": "ResumeBuilder agent skills for resume generation and profile management, as an installable plugin.",
+  "plugins": [
+    {
+      "name": "resumebuilder-skills",
+      "source": "./",
+      "description": "ResumeBuilder agent skills (tailor resume, maintain profile, analyze profile fit, update projects).",
+      "category": "productivity",
+      "keywords": [
+        "resume",
+        "cv",
+        "skills",
+        "ats",
+        "profiling"
+      ]
+    }
+  ]
+}

resumebuilder_tools-1.0.0/.claude-plugin/plugin.json

@@ -0,0 +1,27 @@
+{
+  "name": "resumebuilder-skills",
+  "version": "1.0.0",
+  "description": "ResumeBuilder agent skills for real engineering: tailor resume, maintain profile, analyze profile fit, update projects. Plug-and-play, not vibe coding.",
+  "author": {
+    "name": "Subham Dawn",
+    "url": "https://github.com/S-Dawn"
+  },
+  "homepage": "https://github.com/S-Dawn/ResumeBuilder",
+  "repository": "https://github.com/S-Dawn/ResumeBuilder",
+  "license": "MIT",
+  "keywords": [
+    "resume",
+    "cv",
+    "skills",
+    "ats",
+    "profiling",
+    "career"
+  ],
+  "skills": [
+    "./skills/tailor-resume",
+    "./skills/maintain-profile",
+    "./skills/analyze-profile-fit",
+    "./skills/update-projects",
+    "./skills/setup-resumebuilder-skills"
+  ]
+}

resumebuilder_tools-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,65 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  release:
+    types:
+      - published
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Version
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Create Version Pull Request
+        uses: changesets/action@v1
+        with:
+          version: npm run version
+          publish: npx changeset tag
+          commit: "chore: version skills"
+          title: "chore: version skills"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-python:
+    name: Publish Python engine to PyPI
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Build and publish to PyPI
+        run: |
+          uv build
+          uv publish

resumebuilder_tools-1.0.0/.gitignore

@@ -0,0 +1,36 @@
+# Python cache and bytecode
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# OS/editor noise
+.DS_Store
+# .vscode/
+
+# Generated resume artifacts
+generated/
+/profile/index.yaml
+*.pdf
+*.html
+
+profile/*
+
+# ResumeBuilder skills local config
+resumebuilder-skills.config.json
+
+# OpenSpec-generated agent integrations
+.codex/skills/openspec-*/
+.github/prompts/opsx-*.prompt.md
+.github/skills/openspec-*/
+.opencode/commands/opsx-*.md
+.opencode/skills/openspec-*/

resumebuilder_tools-1.0.0/.vscode/tasks.json

@@ -0,0 +1,49 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"label": "Install Dependencies",
+			"type": "shell",
+			"command": "poetry",
+			"args": [
+				"install",
+				"--compile"
+			]
+		},
+		{
+			"label": "Update OpenSpec Libraries",
+			"type": "shell",
+			"command": "npx",
+			"args": [
+				"--yes",
+				"@fission-ai/openspec@latest",
+				"update"
+			]
+		},
+		{
+			"label": "Build Resume",
+			"type": "shell",
+			"command": "poetry",
+			"args": [
+				"run",
+				"python",
+				"ResumeBuilder.py"
+			],
+			"group": {
+				"kind": "build",
+				"isDefault": true
+			}
+		},
+		{
+			"label": "Run Resume Builder",
+			"type": "shell",
+			"command": "poetry",
+			"args": [
+				"run",
+				"python",
+				"ResumeBuilder.py"
+			],
+			"group": "none"
+		}
+	]
+}

resumebuilder_tools-1.0.0/DESIGN.md

@@ -0,0 +1,76 @@
+# ResumeBuilder Skills Distribution Design
+
+## Goal
+
+Enable users to install ResumeBuilder agent skills into their machine/agent runtime via an install command (e.g. `npx skills@latest add S-Dawn/ResumeBuilder`, `claude plugin install resumebuilder-skills`, etc.), with automatic updates for managed routes.
+
+## Distributable skills (non-openspec only)
+
+The openspec skills (`openspec-*`) are local tooling for this repo's spec-driven workflow and are **excluded** from distribution.
+
+Promoted (shipped) skills:
+
+| Skill | Purpose |
+|-------|---------|
+| `tailor-resume` | Create a job-tailored/master/market resume from the canonical profile |
+| `maintain-profile` | Update the canonical career profile from user-provided facts/resume |
+| `analyze-profile-fit` | Compare profile against a job description; report fit, gaps, improvements |
+| `update-projects` | Refine or add a project in the canonical career profile |
+
+Plus a setup skill:
+
+| Skill | Purpose |
+|-------|---------|
+| `setup-resumebuilder-skills` | One-time per-repo configuration (profile path, output dir, ATS settings) |
+
+## Distribution model (mirrors mattpocock/skills)
+
+The repo does **not** publish an npm package containing the skill code. Instead:
+
+1. Skills live as `SKILL.md` files with YAML frontmatter under `skills/`.
+2. A `.claude-plugin/plugin.json` manifest lists the promoted skill directories (single source of truth, curated subset).
+3. A `.claude-plugin/marketplace.json` makes the repo its own marketplace for Codex, Copilot, and VS Code.
+4. A root `package.json` holds the version used by managed routes to detect updates.
+5. A `scripts/sync-plugin-version.mjs` keeps `plugin.json` version in sync with `package.json`.
+6. `@changesets/cli` drives version bumps and git tags via a GitHub Actions release workflow.
+7. `.agents/install-block.md` is the single source of truth for per-agent install wording, copied verbatim into `README.md`.
+8. `npx skills@latest add S-Dawn/ResumeBuilder -a <agent>` is the universal fallback (skills.sh) for agents without a native plugin system.
+
+## Install routes
+
+| Agent | Command | Auto-updates? |
+|-------|---------|---------------|
+| Claude Code | `claude plugin install resumebuilder-skills` | Yes (official marketplace) |
+| Codex | `codex plugin marketplace add S-Dawn/ResumeBuilder` then `codex plugin add resumebuilder-skills@S-Dawn` | Yes (at startup) |
+| Copilot CLI / VS Code | `copilot plugin marketplace add S-Dawn/ResumeBuilder` then `copilot plugin install resumebuilder-skills@S-Dawn` (+ `autoUpdate: true` in settings) | Yes |
+| Gemini CLI | `gemini skills install https://github.com/S-Dawn/ResumeBuilder.git --path skills/` | No (re-run to update) |
+| Any other agent | `npx skills@latest add S-Dawn/ResumeBuilder -a <agent>` | No (`npx skills update` + re-run `add`) |
+
+## Files to create / modify
+
+| File | Purpose |
+|------|---------|
+| `package.json` | Root package; name `resumebuilder-skills`, version, devDeps (`@changesets/cli`) |
+| `.claude-plugin/plugin.json` | Claude Code plugin manifest; lists promoted skill paths + version |
+| `.claude-plugin/marketplace.json` | Repo-owned marketplace for Codex/Copilot/VS Code |
+| `.agents/install-block.md` | Canonical per-agent install wording (single source of truth) |
+| `scripts/sync-plugin-version.mjs` | Syncs `plugin.json` version from `package.json` |
+| `.changeset/config.json` | Changeset configuration |
+| `.github/workflows/release.yml` | Release workflow: version PR + tag on push to main |
+| `README.md` | Install section (copied from `.agents/install-block.md`) |
+| `skills/setup-resumebuilder-skills/SKILL.md` | New setup skill (one-time per-repo config) |
+| `DESIGN.md` | This document |
+
+## Invocation model
+
+Each skill is either:
+- **User-invoked**: reachable only by the human (`disable-model-invocation: true` in frontmatter; `policy.allow_implicit_invocation: false` in `agents/openai.yaml`).
+- **Model-invoked**: default; reachable by model or user.
+
+All ResumeBuilder distributable skills are user-invoked (the human chooses when to tailor, maintain, analyze, or update).
+
+## Update mechanism
+
+- Managed routes (Claude Code, Codex, Copilot, VS Code) use the `version` field in `plugin.json` to decide when installed users receive an update.
+- `npm run version` runs `changeset version` then `sync-plugin-version.mjs` to keep versions aligned.
+- The universal fallback (`npx skills@latest`) requires the user to re-run `npx skills update` and `add` to pick up new/changed skills.

resumebuilder_tools-1.0.0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.5
+Name: resumebuilder-tools
+Version: 1.0.0
+Summary: Profile-driven ATS-friendly resume generator engine for ResumeBuilder agent skills.
+Author-email: Subham Dawn <coder.sdawn@gmail.com>
+License: MIT
+Keywords: ats,cv,pdf,resume,weasyprint,yaml
+Requires-Python: >=3.11
+Requires-Dist: pillow<14.0,>=13.0
+Requires-Dist: pydyf<0.12,>=0.10
+Requires-Dist: pypdf<7.0,>=6.21.3
+Requires-Dist: pyyaml<7.0,>=6.0.2
+Requires-Dist: weasyprint<71.0,>=70.0
+Description-Content-Type: text/markdown
+
+# ResumeBuilder
+
+A Python/WeasyPrint resume generator with a reusable career evidence profile and GitHub Copilot skill for creating role-specific resume drafts.
+
+## Features
+
+- Keep complete career evidence in `profile/` Markdown records with YAML frontmatter and stable claim IDs.
+- Generate a compact index from profile metadata on demand; the Copilot skill reads only relevant profile details.
+- Tailor a draft from a pasted or file-based job description with a source map and fit report, or create a consolidated master resume when no job description is supplied.
+- Keep each draft's YAML, source map, HTML, and PDF in an isolated directory under `generated/`; tailored drafts include a fit report and master resumes include a conflict report.
+- Check generated YAML, source references, PDF text, conventional section order, and strict one-page fit for tailored drafts. Master resumes retain all profile evidence and may span multiple pages.
+- Preserve the original `resume.yaml` renderer workflow.
+
+## Requirements
+
+- Python `>=3.11`
+- [Poetry](https://python-poetry.org/) for dependency management
+
+## Installation
+
+### Install the skills in your agent
+
+[![skills.sh](https://skills.sh/b/S-Dawn/ResumeBuilder)](https://skills.sh/S-Dawn/ResumeBuilder)
+
+ResumeBuilder agent skills you can install once and use across your agent
+runtime: tailor resume, maintain profile, analyze profile fit, and update
+projects.
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+```bash
+claude plugin install resumebuilder-skills
+```
+
+Updates itself by default.
+
+</details>
+
+<details>
+<summary><strong>Codex</strong></summary>
+
+```bash
+codex plugin marketplace add S-Dawn/ResumeBuilder
+codex plugin add resumebuilder-skills@resumebuilder
+```
+
+Updates itself at startup.
+
+</details>
+
+<details>
+<summary><strong>GitHub Copilot</strong> (CLI and VS Code)</summary>
+
+```bash
+copilot plugin marketplace add S-Dawn/ResumeBuilder
+copilot plugin install resumebuilder-skills@resumebuilder
+```
+
+Then, once, add to `~/.copilot/settings.json`:
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "resumebuilder": { "source": { "source": "github", "repo": "S-Dawn/ResumeBuilder" }, "autoUpdate": true }
+  }
+}
+```
+
+In VS Code, run **Chat: Install Plugin From Source** and enter
+`https://github.com/S-Dawn/ResumeBuilder`. It updates daily.
+
+</details>
+
+<details>
+<summary><strong>Gemini CLI</strong> (manual updates)</summary>
+
+```bash
+gemini skills install https://github.com/S-Dawn/ResumeBuilder.git --path skills/
+```
+
+Re-run to update.
+
+</details>
+
+<details>
+<summary><strong>Any other agent</strong> (manual updates)</summary>
+
+```bash
+npx skills@latest add S-Dawn/ResumeBuilder -a <agent>  # cursor, opencode, devin, windsurf, amp, pi; omit -a to choose
+```
+
+When the installer asks which skills to take, include
+`setup-resumebuilder-skills`. To update, run `npx skills@latest update`, and
+re-run `add` to pick up new skills.
+
+</details>
+
+### Then run setup once per repo
+
+In your agent, run `/setup-resumebuilder-skills`. It configures your profile
+path, draft output directory, and ATS validation tools.
+
+### Install the repo itself (for local development)
+
+```bash
+git clone https://github.com/S-Dawn/ResumeBuilder.git
+cd ResumeBuilder
+poetry install
+```
+
+## Generate from the legacy YAML
+
+```bash
+# Reads resume.yaml and writes HTML/PDF to generated/
+poetry run python ResumeBuilder.py
+
+# Use a custom YAML configuration and output directory
+poetry run python ResumeBuilder.py --config path/to/myresume.yaml --output-dir output/
+
+# Enforce a one-page PDF and extracted-text checks
+poetry run python ResumeBuilder.py --strict-one-page
+```
+
+## Analyze profile fit with GitHub Copilot
+
+Use the **Analyze Profile Fit** skill with a pasted job description or a path to a job-description file to assess a role before deciding whether to apply. It compares relevant job qualifications with evidence in the canonical profile and reports supported, partially supported, and undocumented requirements with profile evidence IDs.
+
+The report includes a qualitative assessment and a transparent weighted evidence-coverage score: supported qualifications receive full credit, partial matches half credit, unsupported qualifications no credit, and explicitly required qualifications count twice as much as preferred or other requirements. The score describes only what the profile documents; it is not a hiring or ATS prediction. The analysis distinguishes information to verify in the profile, positioning ideas based on existing evidence, and conditional skill-development areas.
+
+This diagnostic does not create a resume, application draft, profile update, or retained report. For file-based job descriptions, the skill discloses that relevant job-description and profile contents are sent as context to the configured Copilot model and asks for confirmation before reading the file. The full job description is not retained. Profile silence is not treated as proof that the user lacks a qualification.
+
+## Tailor a resume with GitHub Copilot
+
+Use the **Tailor Resume** skill in GitHub Copilot in VS Code and provide either a pasted job description or a path to a job-description file to create a tailored draft. If you provide no job description, the skill creates a consolidated master resume from all profile records and evidence.
+
+For a master resume, the skill:
+
+1. Reads every indexed profile record and includes all distinct supported details.
+2. Produces `resume.yaml` and a `source-map.json` that trace every content field and cover every non-conflicting profile evidence ID.
+3. Creates `master-report.md` to disclose conflicting claims excluded for clarification.
+4. Creates an isolated `master-resume` draft, renders it, and validates its extracted text and single-column structure without a page or word-count limit.
+
+For a job-tailored draft, the skill:
+
+1. Rebuilds and reads `profile/index.yaml`, then fetches relevant profile records as needed.
+2. Produces a tailored `resume.yaml`, `source-map.json`, and `fit-report.md`.
+3. Creates an isolated application draft under `generated/`, renders it, and checks the actual PDF.
+4. Uses the extracted PDF word count to guide content revisions toward a soft 900-word target without screenshots; strict one-page validation and readability remain authoritative.
+5. Presents the draft for human review; it does not submit applications.
+
+For a market resume (no job description, market-oriented curation), the skill:
+
+1. Infers a candidate target role from the profile's title, domains, skills, and experience evidence.
+2. Presents the inferred role to the user for confirmation; the user may confirm, correct, or exit.
+3. Invokes web search per skill call for current MNC hiring expectations, required skills, and trends for the confirmed role.
+4. Curates profile evidence aligned to those trends under the same word-limit constraint as tailored mode: ~900 words, strict one-page fit, up to eight sequential render attempts.
+5. Produces `market-report.md` documenting the confirmed role, trend sources, omitted-evidence rationale, and conflicting claims.
+6. If web search is unavailable, prompts the user to proceed with the LLM knowledge base or exit; never fabricates trend data.
+
+The skill may substantially rewrite claims, but it must not invent or alter factual claims. It flags conflicting source evidence and, for tailored drafts, identifies unsupported job requirements instead of inventing qualifications. ATS-oriented checks cover text extraction, conventional headings/order, and single-column layout; tailored drafts are also checked for one-page fit. These checks do not guarantee compatibility with every ATS vendor.
+
+Tailored fit reports use `Evidence-backed matches` and `Unsupported or weakly supported requirements` sections. Supported requirements cite profile evidence IDs, and validation rejects unknown IDs or missing sections. Master resumes have no fit report because no target role is assessed.
+
+If an application output already exists, choose a numbered draft, explicitly authorize replacement, or cancel. The default when interaction is unavailable is cancellation. Failed drafts are retained and marked failed for diagnosis.
+
+### Copilot data handling
+
+Selected profile records and the job description are sent as context to the user's configured Copilot model. Do not store secrets in profile records. The full job description is not copied into retained generated artifacts.
+
+## Maintain the profile
+
+See [profile/README.md](profile/README.md) for the Markdown/frontmatter format, stable evidence IDs, validation, and index behavior. Validate and rebuild the compact index with:
+
+```bash
+poetry run python resume_tools.py validate-profile
+poetry run python resume_tools.py profile-index
+```
+
+Use the **Maintain Profile** Copilot skill for full-resume or career-fact consolidation, and **Update Projects** for focused changes to project records. Both preview and validate the complete update before requesting explicit approval; neither treats a tailored application resume as a canonical source. File and selected project-repository content is sent to the configured Copilot model only after disclosure and confirmation.
+
+## Renderer YAML structure
+
+The renderer uses `highlights` for experience and project bullets:
+
+```yaml
+profile:
+  name: Your Name
+  title: Your Job Title
+  phone: "+1 234 567 8900"
+  email: you@example.com
+  location: City, Country
+  links:
+    - label: LinkedIn
+      url: "https://linkedin.com/in/yourprofile"
+summary: A concise professional summary.
+skills:
+  - category: Languages
+    items: [Python, Java]
+experience:
+  - role: Senior Software Engineer
+    company: Acme Corp
+    location: Remote
+    duration: Jan 2022 - Present
+    highlights:
+      - Built scalable microservices handling 10k requests per second.
+projects:
+  - name: Example Project
+    highlights:
+      - Reduced processing time by 30%.
+education:
+  - degree: B.Tech in Computer Science
+    institution: Example University
+    date: 2019
+    score: "GPA: 3.8"
+certifications_and_achievements:
+  - "Achievements: Example Award"
+  - "Certifications: Example Certificate"
+```
+
+Empty optional sections are omitted from the rendered output.