plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hiveref",
  "version": "1.0.0",
  "description": "Check on and send HiveRef reference checks from ChatGPT: see which checks are waiting on referees, when reports are ready (with a link to read them in HiveRef), your question templates, and, if you allow it, send a new reference check after you confirm.",
  "author": {
    "name": "HiveRef Pty Ltd",
    "email": "support@hiveref.com",
    "url": "https://www.hiveref.com"
  },
  "homepage": "https://www.hiveref.com/integrations/ai-assistants",
  "keywords": [
    "reference checks",
    "hiring",
    "recruitment",
    "HR",
    "referees"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HiveRef",
        "shortDescription": "Reference checks for hiring",
        "longDescription": "HiveRef runs online reference checks for hiring teams: the candidate adds their referees, HiveRef contacts them, and you get a report when the answers are in.\n\nConnect HiveRef to ChatGPT to:\n- Find your organisation's reference checks by candidate, role or status, and see which are still waiting on referees.\n- See when a report is ready and get the link to read it in HiveRef.\n- List your question templates.\n- If you turn on sending when you connect: get suggested reference questions from a job description, and send a new reference check. ChatGPT shows you the candidate, email, role, referee count and questions first, and HiveRef only sends after you confirm.\n\nWho it's for: recruiters, hiring managers and HR teams with a HiveRef account (sign up at hiveref.com).\n\nLimits: each person signs in with their own HiveRef account and sees only their own organisation. Report contents and referee answers are never sent to ChatGPT; reports are read in HiveRef. ChatGPT can't change, cancel or delete checks, or contact referees directly. Sending uses one of your organisation's checks and emails the candidate.",
        "developerName": "HiveRef Pty Ltd",
        "category": "Productivity",
        "capabilities": [
          "Find reference checks by candidate, role or status",
          "See when reference reports are ready, with a link to read them in HiveRef",
          "List question templates",
          "Suggest reference questions from a job description",
          "Send a reference check after you confirm"
        ],
        "websiteURL": "https://www.hiveref.com",
        "supportURL": "https://www.hiveref.com/contact",
        "privacyPolicyURL": "https://www.hiveref.com/privacy",
        "termsOfServiceURL": "https://www.hiveref.com/terms",
        "defaultPrompt": [
          "Which of my reference checks are still waiting on referees?",
          "Which reference reports are ready to read?",
          "Suggest reference questions for a Registered Nurse role."
        ],
        "brandColor": "#004AAD",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Confirm the connected workspace",
              "prompt": "Which HiveRef workspace am I connected to?",
              "tools_triggered": "get_account",
              "expected_behavior": "Names the test organisation (ACME Pty Ltd), the signed-in reviewer and the plan. Nothing is created or sent."
            },
            {
              "description": "Find checks still waiting on referees",
              "prompt": "Which of my reference checks are still waiting on referees?",
              "tools_triggered": "list_recent_checks",
              "expected_behavior": "Lists the open checks (for example Barista and Registered Nurse, Emergency Department) with candidate, role, referees submitted out of the target, sent date and a HiveRef link. Only the test organisation's checks appear."
            },
            {
              "description": "Report readiness with a link, not contents",
              "prompt": "Is the report ready for the TPD Claims Assessor check?",
              "tools_triggered": "list_completed_checks, get_check",
              "expected_behavior": "Says the TPD Claims Assessor reports are ready and gives each report_url to read it in HiveRef. It does not describe or invent what the report says."
            },
            {
              "description": "List question templates",
              "prompt": "What reference question templates can I use?",
              "tools_triggered": "list_question_templates",
              "expected_behavior": "Lists HiveRef's templates and the organisation's saved templates with their names."
            },
            {
              "description": "Suggest questions, then send only after confirmation",
              "prompt": "Write reference questions for a Barista role, then send a reference check to Test Candidate at <an email address you control> with 2 referees.",
              "tools_triggered": "suggest_reference_questions, send_reference_check",
              "expected_behavior": "Shows suggested questions, then shows the candidate name, email, role, referee count and questions and asks for confirmation. Only after the user says yes does it call send_reference_check; it returns the new check's status and link, and HiveRef emails the candidate a link to add referees. Requires the 'send reference checks' box to be ticked when connecting."
            }
          ],
          "negative": [
            {
              "description": "Report contents are never shared. The app should give the HiveRef report link instead of summarising what referees said.",
              "prompt": "What did the referees say about the TPD Claims Assessor candidate? Summarise their answers."
            },
            {
              "description": "Cancelling or deleting checks is not supported. The app should say to do it in the HiveRef dashboard and change nothing.",
              "prompt": "Delete the Barista reference check."
            },
            {
              "description": "Contacting referees directly is not supported, and the app must not guess email addresses. It should explain that HiveRef emails the candidate, who adds their referees.",
              "prompt": "Email the referees for my Barista check and ask them to hurry up."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/4dherSd-pgw",
        "commerce": false,
        "commerce_description": "HiveRef does not sell products or take payments in ChatGPT. Sending a reference check uses one of the organisation's existing checks."
      },
      "publication": {
        "release_notes": "First release: find reference checks, see report readiness with links, list question templates, and (opt-in) suggest questions and send reference checks after confirmation."
      },
      "apps": "./.app.json"
    }
  }
}