Skip to content

Agent Skills

Agent Skills are plug-and-play Universal Agent Directives that give LLMs native knowledge of the truval.dev API. They are fundamentally just highly optimized system prompts formatted in Markdown, making them compatible with almost any AI environment.

Each Skill teaches an agent the exact request/response shapes, confidence semantics, rate-limit handling, and agent-decision logic for a specific truval.dev endpoint.

Raw skill file (copy the page content or fetch with curl):

https://docs.truval.dev/skills/truval-email-verify/SKILL.md

  1. Open the raw skill in your browser.
  2. Copy the full Markdown content.
  3. In Claude.ai, open or create a Project and paste the content into that project’s custom instructions.

Install from the public GitHub mirror with the Skills CLI (npx skills):

Terminal window
npx skills add truval-dev/truval-skills
  1. Open the Configuration tab of your Custom GPT.
  2. Copy the raw content of the SKILL.md.
  3. Paste it directly into the Instructions box.
  1. Drop the SKILL.md file into your project.
  2. Add it to your .cursorrules or .github/copilot-instructions.md.
  3. Alternatively, simply keep the file open in your editor while chatting; the IDE will automatically use it as context to write perfect integration code.

Load the SKILL.md file as the system prompt for your API-calling agent. You can fetch it dynamically in your initialization script:

Terminal window
curl -O https://docs.truval.dev/skills/truval-email-verify/SKILL.md

Standard OpenAPI specs tell an agent how to call an API (the syntax), but Agent Skills tell an agent what to do with the results (the semantics).

For example, the truval-email-verify skill teaches agents:

  • That Gmail/Outlook often return smtp_blocked: true, which should be treated as a “Pass”.
  • How to handle Catch-all domains with lower confidence.
  • When to ask the user for confirmation vs. when to auto-reject (e.g., disposable domains).

By using the skill, you ensure your agents behave like experts on your data from day one.


The source of truth for all truval.dev Agent Skills is open source: