# Provider Naming

> Enforces consistent naming for provider auxiliary functions in src/providers/. Use when creating, renaming, or reviewing provider modules or their tests. Use when this capability is needed.

- Skill: `tomevault-io/provider-naming` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/provider-naming`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/provider-naming/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/provider-naming

---


# Provider Naming

All provider auxiliary functions in `src/providers/` must use consistent names:

- `getAvatarUrl(input)` — builds the URL to visit/scrape from user input (input → URL string). Passed as `url` to `createHtmlProvider`.
- `getAvatar($)` — extracts the avatar URL from fetched HTML markup (cheerio $ → URL string). Passed as `getter` to `createHtmlProvider`.
- `parseInput(input)` — parses input when multiple formats are supported (e.g. "type:id"). Never prefix with provider name.

Exports should be `module.exports.getAvatarUrl`, `module.exports.getAvatar`, `module.exports.parseInput`. Update corresponding test files in `test/unit/providers/` when renaming.

---
> Source: [microlinkhq/unavatar](https://github.com/microlinkhq/unavatar) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-19 -->

