valyu-best-practices

The valyu-best-practices skill provides structured guidance for integrating and using the Valyu API ecosystem in AI agents and applications. It helps developers perform real-time search across multiple domains, including web content, academic research, financial data, medical information, transportation sources, and news. The skill also covers content extraction from URLs, AI-generated answers with citations, and comprehensive deep research workflows. A core focus of the skill is enforcing best practices for implementation, particularly the mandatory use of official Valyu SDK libraries instead of direct HTTP requests, ensuring safer, more maintainable, and future-compatible integrations.

The skill includes guidance for selecting the correct API based on the task being performed, such as using the Search API for multi-source discovery, the Contents API for extracting information from URLs, the Answer API for AI-synthesized responses with citations, and the DeepResearch API for generating research reports. It supports both JavaScript/TypeScript and Python environments through the official `valyu-js` and `valyu` SDKs. The documentation emphasizes advantages of SDK usage, including type safety, automatic retries, streaming support, structured error handling, and compatibility with future API updates. It also outlines supported search domains and available search types such as `all`, `web`, `proprietary`, and `news`.

This skill is designed for developers, AI engineers, research teams, and organizations building AI-powered assistants, research tools, monitoring systems, or data aggregation workflows. It is especially useful for applications that require reliable access to up-to-date information across specialized and proprietary sources. The skill is appropriate for teams working in academic research, healthcare, finance, media monitoring, and enterprise AI systems where citation-backed answers and comprehensive research capabilities are important.