{
 "schema": "aiblocks-page/1",
 "id": "notion-help-article-finder",
 "type": "skill",
 "name": "Notion help article finder",
 "summary": "Share a customer question. Find matching Notion articles, useful excerpts and a reply draft through Composio.",
 "headline": "Notion help article finder",
 "subhead": "Share the customer question and connect Notion through the Composio CLI. It searches titles and related words, then reads the strongest matches. You get article links, useful excerpts, a reply draft and gaps in the help content. Missing access or weak matches stay visible; it does not send the reply.",
 "job": {
  "id": "help-customers",
  "name": "Help your customers"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "tool_connection",
   "required": true,
   "label": "Tool connection",
   "what": "an AI connected to an outside tool or service, such as an MCP server"
  }
 ],
 "outputs": [
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  }
 ],
 "you_give": [
  "The customer's question or topic.",
  "Your Notion workspace with your help articles, connected through Composio."
 ],
 "you_get": [
  "Links to the best matching Notion articles, with the date each was last updated.",
  "Short excerpts from each article that answer the question.",
  "A reply to the customer, drafted from those articles.",
  "A list of missing or out-of-date help topics."
 ],
 "use_when": [
  "A customer asks a question and you think the answer is already in your Notion help pages.",
  "You need a quick reply that is based on your own articles.",
  "You want to check whether a help article is out of date.",
  "You want to spot topics your help pages do not cover yet."
 ],
 "skip_when": [
  "You need to fix a product bug or a billing dispute: use your ticket system or ask a teammate who owns it.",
  "Your help articles are not in Notion: search that tool directly, or paste the article text into your AI and ask it to draft a reply.",
  "You want to write a new help article from scratch: write it yourself or ask your AI for a draft, then add it to Notion."
 ],
 "output_sample": {
  "input": [
   "The customer's question or topic",
   "Your Notion workspace, connected to the Composio tool"
  ],
  "prerequisites": [
   "An AI that can run commands and read skill files",
   "The Composio CLI installed, with your Notion account linked",
   "Notion pages that hold your help content"
  ],
  "output": [
   {
    "name": "Top Matches",
    "contains": "The best 3 to 5 pages, each with its title, last updated date, how relevant it is, and a link."
   },
   {
    "name": "Key excerpts",
    "contains": "The parts of each page that answer the question, quoted as written."
   },
   {
    "name": "How to use this",
    "contains": "A short note under each match on how it helps answer the customer."
   },
   {
    "name": "Suggested Response",
    "contains": "A reply to the customer drafted from the articles found."
   },
   {
    "name": "Gaps",
    "contains": "Topics your help pages do not cover and articles that look out of date."
   },
   {
    "name": "If nothing is found",
    "contains": "Other search words to try and whether a new help article is worth writing."
   }
  ]
 },
 "how_to_use": [
  "Use an AI that can run commands and read files. A chat window alone will not work for live Notion search.",
  "Composio is a separate service with its own plan and limits, so check its site before you start. Install the Composio CLI and link your Notion account. Your AI will ask you to run composio link notion if it is not linked.",
  "Add the skill folder to your AI and ask for the Notion help article finder.",
  "Type the customer's question or topic.",
  "Read the excerpts and the reply draft. Check each against the linked article before you send anything.",
  "Use the Gaps list to decide which help articles to write or update. Give each gap to one owner, and ask your AI for a short draft of the first missing article."
 ],
 "checks": [],
 "next": [
  {
   "name": "Support ticket help article writer",
   "url": "https://useaiblocks.com/skills/solved-ticket-help-page-writer",
   "why": "Support ticket help article writer"
  }
 ],
 "source": {
  "by": "Composio",
  "repo": "composio-community/support-skills",
  "url": "https://github.com/composio-community/support-skills/tree/83382c4b055fc4e5b055044adb5bfb7585484c9a/knowledge-search",
  "licence": "MIT",
  "original_name": "knowledge-search",
  "commit": "83382c4b055fc4e5b055044adb5bfb7585484c9a"
 },
 "credits": [
  {
   "title": "knowledge-search skill",
   "by": "Composio",
   "url": "https://github.com/composio-community/support-skills/tree/83382c4b055fc4e5b055044adb5bfb7585484c9a/knowledge-search",
   "used": "Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps."
  }
 ],
 "files": [
  "README.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/notion-help-article-finder",
  "markdown": "https://useaiblocks.com/skills/notion-help-article-finder.md",
  "json": "https://useaiblocks.com/skills/notion-help-article-finder.json",
  "instructions": "https://useaiblocks.com/skills/notion-help-article-finder/SKILL.md",
  "download": "https://useaiblocks.com/skills/notion-help-article-finder.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/notion-help-article-finder",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/notion-help-article-finder",
  "mcp": "https://useaiblocks.com/mcp"
 }
}