# Faker

> Use when writing Vague (.vague) files that need realistic test data using faker generators for names, emails, addresses, dates, and more

- Skill: `tomevault-io/faker` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/faker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/faker/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/faker

---


# Faker Plugin for Vague

## Quick Start

```vague
schema User {
  id: uuid()
  name: fullName()
  email: email()
  phone: phone()
  city: city()
}
```

## Core Principles

- Use shorthand generators for common cases (no `faker.` prefix needed)
- Use full namespace `faker.module.method()` for less common generators

## Common Shorthand Generators

`uuid()`, `email()`, `phone()`, `firstName()`, `lastName()`, `fullName()`, `companyName()`, `city()`, `country()`, `countryCode()`, `zipCode()`, `streetAddress()`, `url()`, `avatar()`, `iban()`, `currencyCode()`, `pastDate()`, `futureDate()`, `sentence()`, `paragraph()`

## Full Namespace Example

```vague
schema Employee {
  title: faker.person.jobTitle()
  bio: faker.lorem.sentences(3)
  cardNumber: faker.finance.creditCardNumber()
}
```

## Reference Files

For complete generator list: [references/generators.md](references/generators.md)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/mcclowes) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->