playbooks

home / skills / ontos-ai / skills-evaluator / faq-finder

faq-finder skill

/test-skills/faq-finder

This skill helps users locate and retrieve relevant FAQ information quickly by keyword-driven searches and direct answer extraction.

npx playbooks add skill ontos-ai/skills-evaluator --skill faq-finder

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.0 KB
---
name: faq-finder
description: Searches for and retrieves information from FAQ (Frequently Asked Questions) pages based on keywords.
---
---
name: faq-finder
description: Searches for and retrieves information from FAQ (Frequently Asked Questions) pages based on keywords.
tags:
  - faq
  - search
  - information retrieval
  - customer support
---

# FAQ Finder Skill

This skill is designed to help users quickly locate answers to common questions by searching through FAQ pages. It can be used to find specific information related to a topic, such as "ticket delivery" or "refund policy."

## Core Functionality

1.  **Keyword-based Search**: Takes keywords or phrases as input to search for relevant FAQ entries.
2.  **Contextual Understanding**: Attempts to understand the user's intent to refine the search and provide the most accurate FAQ section or answer.
3.  **Direct Answer Extraction**: If possible, extracts and presents the direct answer to the question from the FAQ content.
4.  **Link Provision**: Provides a direct link to the relevant FAQ page or section for the user to review the full context.

## Usage

**Trigger**: "Find the FAQ about [topic]" or "Where is the FAQ page for [topic]?"

### Parameters

*   `topic`: (Required) The subject or keywords for which the user wants to find FAQ information (e.g., "ticket delivery", "account setup", "payment methods").
*   `source_url`: (Optional) A specific URL to an FAQ page or website to search within. If not provided, the skill might use a general search or a pre-configured list of common FAQ sources.

### Example Interaction

**User**: "Find the FAQ page about ticket delivery."

**Agent (using faq-finder)**:
1.  Identifies `topic` as "ticket delivery."
2.  Searches known FAQ sources or performs a web search for "ticket delivery FAQ."
3.  Locates a relevant FAQ page.
4.  **Output**: "I found an FAQ section on ticket delivery. You can find information regarding e-tickets, mail delivery, and collection options here: [Link to FAQ page/section]."

Overview

This skill helps users locate precise answers from FAQ pages by searching with keywords or short phrases. It focuses on quickly surfacing the most relevant FAQ entry and, when possible, extracts the direct answer. The skill also returns links to the original FAQ section so users can review full context.

How this skill works

Users provide a topic or keywords and the skill searches specified FAQ sources or performs a targeted web search for matching FAQ content. It ranks candidate FAQ entries by relevance, attempts to infer user intent to narrow results, and extracts a concise answer snippet when available. The skill always provides a link to the original FAQ page or section for full context and verification.

When to use it

  • When you need a quick answer to a common question (e.g., refunds, delivery, account setup).
  • When you want the exact FAQ page or section link for documentation or support tickets.
  • When you need to extract a concise answer from long FAQ pages.
  • When support agents or bots must reference authoritative FAQ text quickly.
  • When validating whether a question is already covered in public FAQs.

Best practices

  • Provide clear, specific keywords or a short phrase to improve match accuracy.
  • Include a source_url when you want the search limited to a particular site.
  • Use follow-up queries to refine results if the first match is too broad.
  • Verify extracted snippets against the linked FAQ page before using them in official responses.
  • Prefer topic terms used by the target site (e.g., ‘refund policy’ vs. ‘money back’) for better hits.

Example use cases

  • Customer asks about ticket delivery—skill returns the FAQ entry and link to delivery options.
  • Support agent needs the official refund policy paragraph to paste into a reply.
  • Product manager checks whether a new question is already covered in public FAQs.
  • Bot automation uses the extracted answer to provide an immediate response and attach the FAQ link.

FAQ

What input does the skill require?

At minimum a topic or keyword phrase is required; you can optionally provide a source_url to limit the search.

Can the skill extract exact answers from long FAQ pages?

Yes. It attempts to extract concise answer snippets and returns the source link for full context and verification.