# Oh My Resume

> Use when creating, editing, checking, theming, or exporting resumes from Markdown with Oh My Resume. The skill includes a bundled CLI and templates, so users can ask for a resume PDF without installing the npm package first.

- **Type:** Skill
- **Install:** `agentstack add skill-open-agent-power-oh-my-resume-oh-my-resume`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [open-agent-power](https://agentstack.voostack.com/s/open-agent-power)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [open-agent-power](https://github.com/open-agent-power)
- **Source:** https://github.com/open-agent-power/oh-my-resume

## Install

```sh
agentstack add skill-open-agent-power-oh-my-resume-oh-my-resume
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Oh My Resume

Use this skill to turn a Markdown resume into a same-folder PDF, HTML preview, or source package. The user should mostly see and edit only the Markdown input, local config, and final output.

## Priority

Prefer the bundled CLI shipped with this skill. Users do not need to install an npm package.

Find the skill directory from the loaded `SKILL.md` path. The bundled CLI is:

```bash
node /assets/oh-my-resume/scripts/cli.js
```

## Agent Workflow

1. Run environment checks first. On Windows first-run, prefer the bundled setup helper before `doctor`:

```bat
\assets\oh-my-resume\install.bat
```

Then check the environment:

```bash
node /assets/oh-my-resume/scripts/cli.js doctor
```

If TeX is missing, report the exact install command instead of continuing to PDF:

```bash
brew install --cask mactex-no-gui
```

2. Choose the Markdown resume file explicitly. Do not rely on implicit discovery. By convention:

- `resume.md` generates `resume.pdf`
- `candidate.md` generates `candidate.pdf`
- generated LaTeX stays under `build/`
- LaTeX logs and auxiliary files also stay under `build/`

If the user has no Markdown resume yet, initialize one:

```bash
node /assets/oh-my-resume/scripts/cli.js init .
```

This creates:

- `resume.md`
- `omr.config.json`
- `themes/classic.tex`

3. Edit `resume.md` for content. Keep generated files out of manual edits.

Supported Markdown:

- `#` top-level heading blocks
- `##` sections
- `###` entries, with optional inline tags and right-aligned time:

```md
### Title`tag` 2024 - 2025
```
- `时间：` dates and `标签：` badges as compatibility field lines
- any other `xxx：yyy` entry line as a normal field line
- bullets for achievements, including nested bullets by indentation:

```md
- Level 1
  - Level 2
    - Level 3
```
- `**bold**`, `` `tag` ``, and Markdown links

4. Generate the PDF by passing the Markdown file:

```bash
node /assets/oh-my-resume/scripts/cli.js pdf resume.md
```

Expected output:

```text
Generated build/resume.tex from resume.md
Generated resume.pdf
```

For a fast browser preview without TeX compilation, generate HTML:

```bash
node /assets/oh-my-resume/scripts/cli.js html resume.md
```

For users who cannot run TeX, export a fallback PDF from the HTML renderer. This requires Google Chrome, Microsoft Edge, or Chromium; users can set `OMR_HTML_PDF_BROWSER` to an explicit browser executable path when auto-detection fails:

```bash
node /assets/oh-my-resume/scripts/cli.js html-pdf resume.md
```

To export a source package with Markdown, config, generated LaTeX, HTML, and required template sources:

```bash
node /assets/oh-my-resume/scripts/cli.js export resume.md
```

5. For iterative editing, use debug mode with an explicit file:

```bash
node /assets/oh-my-resume/scripts/cli.js debug resume.md
```

This opens a local browser page with Markdown editing on the left and preview on the right. The user can choose `LaTeX PDF` or `HTML 快速预览`, then click render to save Markdown and regenerate the selected output. The `HTML 导出 PDF` button generates the browser-rendered fallback PDF. The debug session stays running until the terminal process is stopped.

The debug page also includes `Style` and source export controls. Use `Style` when the user wants to tune fonts, heading sizes, body size, tag colors, section colors, page margins, photo width/height, header gap, or date/tag field names. The button writes standard `omr.config.json`; users may also edit that JSON directly. Local templates are read from `omr.styles/*.json`; no built-in style preset is shown in the template picker.

Use the advanced `watch` command only when the user explicitly asks for terminal-based file watching.

6. Validate the PDF. If layout is crowded, first shorten Markdown content; then adjust `omr.config.json`; only edit `themes/*.tex` for full custom design.

## Customization

Use `omr.config.json` for simple theme overrides:

```json
{
  "theme": {
    "colors": {
      "omrAccent": "59,130,246",
      "omrTagBg": "232,241,255"
    },
    "lengths": {
      "omrPageMarginLeft": "8mm",
      "omrPhotoWidth": "2.15cm",
      "omrPhotoHeight": "2.55cm",
      "omrHeaderGap": "6mm"
    },
    "fonts": {
      "omrBodyFont": "TeX Gyre Termes",
      "omrCJKMainFont": "Songti SC"
    },
    "sizes": {
      "omrBodyFontSize": "10pt",
      "omrSectionFontSize": "12pt",
      "omrEntryFontSize": "10.5pt"
    }
  },
  "markdown": {
    "dateFields": ["时间", "日期", "date", "dates"],
    "tagFields": ["标签", "tags"]
  }
}
```

Use a custom LaTeX theme only when needed:

```yaml
theme: ./themes/classic.tex
```

## Output Contract

When done, tell the user:

- The Markdown input path.
- The PDF output path.
- The HTML/source output path, when used.
- Whether environment checks passed.
- Whether debug mode is running, when used.
- Any remaining layout risk, such as content spilling to multiple pages.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [open-agent-power](https://github.com/open-agent-power)
- **Source:** [open-agent-power/oh-my-resume](https://github.com/open-agent-power/oh-my-resume)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-open-agent-power-oh-my-resume-oh-my-resume
- Seller: https://agentstack.voostack.com/s/open-agent-power
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.