# Provider Naming

> Provider Naming is an Agent Skill for development published in the microlinkhq/unavatar repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `provider-naming`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/microlinkhq/unavatar/blob/HEAD/.agents/skills/provider-naming/SKILL.md
- Repository: microlinkhq/unavatar (1,448 GitHub stars when collected)

## SKILL.md

# 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: https://www.openparable.com/skill/development/provider-naming (OpenParable). Cite the canonical URL above.
