truval.dev skills

Agent Skills for truval.dev — plug-and-play Universal Agent Directives that give LLMs native knowledge of the truval.dev API.

What is this?

@truval/skills bundles Universal Agent Skills for the truval.dev APIs. Each Skill teaches LLMs and autonomous agents the exact request/response shapes, confidence semantics, rate-limit handling, and agent-decision logic for a specific endpoint — so your integrations call the API correctly without bespoke system prompts.

Available Skills

| Skill | Endpoint | Description | |-------|----------|-------------| | truval-email-verify | POST /v1/email/verify | Verify email deliverability and validity |

Usage

Skills are fundamentally just highly optimized system prompts formatting in Markdown, making them compatible with almost any AI environment.

OpenAI / ChatGPT (Custom GPT)

Copy the raw SKILL.md content and paste it directly into the Instructions box of a Custom GPT to give it native API awareness.

Cursor / Windsurf / GitHub Copilot

Drop SKILL.md into your .cursorrules file or simply keep it in your workspace context to ensure the IDE writes perfect integration code.

LangChain / CrewAI / Agent Frameworks

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

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

Claude.ai & Claude Code

1. For Claude.ai, add the URL directly via Project → Skills → Add Skill:

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

2. Or use the CLI installer:

   npx skills add truval/truval-skills

How it works

Skills are Markdown files (often with a YAML frontmatter description that specific orchestrators use) designed to teach an LLM an API. The body contains the complete API reference, response schemas, and agent-decision logic — everything the AI needs embedded directly, with no external lookups required at runtime.

Repository structure

truval-skills/
├── truval-email-verify/
│   └── SKILL.md        ← Agent Skill for email verification
├── README.md
├── LICENSE.md
└── package.json

Contributing

Issues and pull requests are welcome on GitHub.

Links

• API Docs: docs.truval.dev
• MCP Server: https://mcp.truval.dev/mcp
• Dashboard: dash.truval.dev
• npm SDK: truval