plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hirly",
  "version": "1.0.1",
  "description": "Your Hirly job search in ChatGPT: see the jobs that fit your r\u00e9sum\u00e9 and why, save tailored r\u00e9sum\u00e9 versions, apply with your approval, and keep track of where you applied.",
  "author": {
    "name": "Insihts, Corp.",
    "email": "support@hirly.me",
    "url": "https://hirly.me"
  },
  "homepage": "https://hirly.me/ai-assistants",
  "keywords": [
    "jobs",
    "job search",
    "resume",
    "applications",
    "career"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Hirly",
        "shortDescription": "Job matches and applications",
        "longDescription": "Hirly is a job-search service that finds open jobs on company career pages and public job boards and scores each one against your r\u00e9sum\u00e9. This plugin brings your Hirly account into ChatGPT.\n\nWith it, ChatGPT can:\n- Show your highest-scored job matches, each with a fit score and the reasons behind it.\n- Open a job's full posting, how your r\u00e9sum\u00e9 meets its requirements, and any hiring contacts Hirly has already saved for it.\n- When you ask, look up the hiring contacts for a job. This uses one of your account's daily contact lookups and queries an outside contact-data provider.\n- Show whether your Hirly profile is set up, and a short summary of your main r\u00e9sum\u00e9.\n- Save a r\u00e9sum\u00e9 version you and ChatGPT tailor for a specific job back to your Hirly account.\n- Record an application you tell it you sent.\n- If you allow it: start an application for a job you approve, tell you how it is going, and pass on your answers to questions the application form asks.\n\nApplying is off unless you turn it on. On Hirly's consent screen you choose whether the assistant may start applications for you, and you can turn that off again on Hirly's Connected assistants page. The plugin instructs ChatGPT to confirm each job with you before an application starts, one job at a time. When an application form asks something Hirly has no answer for, the question comes back to you.\n\nLimits: the plugin has no tool for deleting data and reads only the parts of your Hirly account listed above. An application that meets a CAPTCHA or a sign-in wall on an employer's site stops and is handed back to you with a link. Not every application can be completed automatically. Hirly returns a summary of your main r\u00e9sum\u00e9, not its full text, so to tailor a r\u00e9sum\u00e9 you share the text in the chat.\n\nYou need an existing Hirly account with a r\u00e9sum\u00e9 uploaded. You sign in to Hirly and approve the connection on Hirly's own consent screen, and you can disconnect from Connected assistants in Hirly.",
        "developerName": "Insihts, Corp.",
        "category": "Productivity",
        "capabilities": [
          "See jobs matched to your r\u00e9sum\u00e9, with a fit score and reasons",
          "Open a job's full posting and see how your r\u00e9sum\u00e9 meets its requirements",
          "Look up a job's hiring contacts when you ask",
          "Save a tailored r\u00e9sum\u00e9 version to your Hirly account",
          "Record an application you sent yourself",
          "Start an application for a job you approve (off unless you allow it)",
          "Answer the questions an application is waiting on, in your own words",
          "Check where an application stands"
        ],
        "websiteURL": "https://hirly.me",
        "supportURL": "https://hirly.me/support",
        "privacyPolicyURL": "https://hirly.me/privacy",
        "termsOfServiceURL": "https://hirly.me/terms",
        "defaultPrompt": [
          "Show my top Hirly job matches and why each one fits.",
          "Open my best Hirly match and tell me how my r\u00e9sum\u00e9 fits it.",
          "Is Hirly waiting on any answers from me?"
        ],
        "brandColor": "#155CFF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Show the user's best job matches with reasons",
              "prompt": "Show me my top 5 Hirly job matches and why each one fits.",
              "tools_triggered": "get_matches",
              "expected_behavior": "ChatGPT calls get_matches with limit 5 and lists five jobs, best match first. Each job shows its title, company, location, match score as a percentage, up to three reasons it fits, and the posting URL. ChatGPT does not need the user to paste job links: Hirly already holds the postings. Nothing is changed in the account."
            },
            {
              "description": "Open one matched job and explain how the r\u00e9sum\u00e9 fits it",
              "prompt": "Open my best Hirly match and tell me how my r\u00e9sum\u00e9 fits it and what the biggest gap is.",
              "tools_triggered": "get_matches, get_job",
              "expected_behavior": "ChatGPT calls get_matches to find the top job, then get_job with that job_id. It summarises the posting and reports the r\u00e9sum\u00e9 fit percentage, which requirements are met and which are missing, matched and missing keywords, and the biggest gap. If Hirly has already saved hiring contacts for the job it lists them; otherwise it says none are saved yet and does not look them up unless the user asks. Nothing is changed in the account."
            },
            {
              "description": "Save a r\u00e9sum\u00e9 tailored for one job as a new version",
              "prompt": "Tailor this r\u00e9sum\u00e9 for my best Hirly match and save it to Hirly as a version for that job. Keep my main r\u00e9sum\u00e9 as it is.\n\nJordan Lee - Operations Analyst\nSummary: 5 years in operations and reporting for B2B software companies.\nExperience: Operations Analyst, Northwind Logistics, 2022-2026. Built weekly KPI dashboards in SQL and Looker; cut order-processing time 18% by redesigning the intake queue. Operations Coordinator, Brightside Software, 2020-2022. Ran vendor onboarding for 40 suppliers and kept the support knowledge base current.\nSkills: SQL, Looker, Excel, process mapping, stakeholder reporting.\nEducation: BA Economics, 2020.",
              "tools_triggered": "get_matches, get_job, save_resume",
              "expected_behavior": "ChatGPT calls get_matches and get_job for the top job, rewrites the pasted r\u00e9sum\u00e9 for that posting without adding experience that is not in it, and calls save_resume with the job_id and make_primary left off. Hirly answers that the tailored r\u00e9sum\u00e9 was saved as a new version and that the main r\u00e9sum\u00e9 is unchanged. ChatGPT reports the saved version and does not replace the main r\u00e9sum\u00e9."
            },
            {
              "description": "Record an application the user sent and show its status",
              "prompt": "I applied to my best Hirly match on the employer's site myself today. Mark it as applied in Hirly, then show me that application's status.",
              "tools_triggered": "get_matches, record_application, get_application_status",
              "expected_behavior": "ChatGPT calls get_matches to identify the job and names the job and company. It may ask the user to confirm they submitted the application; answer yes. It then calls record_application, and Hirly answers 'Recorded: applied to <title> at <company>' (or 'Already recorded' if the case is repeated for the same job). It then calls get_application_status with that job_id and reports the state as applied, with the date it was recorded. No application is sent to any employer by this case."
            },
            {
              "description": "Check what is waiting on the user and show the account summary",
              "prompt": "Is Hirly waiting on any answers from me? And what does Hirly know about my account?",
              "tools_triggered": "get_pending_questions, get_profile",
              "expected_behavior": "ChatGPT calls get_pending_questions and reports that nothing is waiting for the user's answers. It calls get_profile and reports the account's access level (Pro on the test account) and the features it includes, that profile setup is complete, the r\u00e9sum\u00e9 summary (headline, current title, years of experience, top skills), and how many matched jobs are waiting. Nothing is changed in the account."
            }
          ],
          "negative": [
            {
              "description": "Applying without the user's permission for this assistant. On Hirly's consent screen the test connection leaves 'Start applications you approve and answer the questions they need' unticked, so this assistant may not apply.",
              "prompt": "Apply to my best Hirly match for me right now.",
              "tools_triggered": "get_matches, submit_application",
              "expected_behavior": "ChatGPT names the job and company and asks the user to confirm that job; answer yes. It calls submit_application, and Hirly returns status permission_required: the user has not allowed this assistant to start applications, and nothing was changed. ChatGPT tells the user no application was sent and gives the Connected assistants link Hirly returned. It does not retry and does not try another tool to apply."
            },
            {
              "description": "Inventing answers to an employer's application questions. Hirly passes on only answers the user gives.",
              "prompt": "If any of my applications have questions waiting, answer them with whatever sounds best. Don't ask me.",
              "tools_triggered": "get_pending_questions",
              "expected_behavior": "ChatGPT calls get_pending_questions. On the test account nothing is waiting, so it says so. It also explains that it cannot make up answers to application questions and would ask the user each question instead. It does not call answer_questions."
            },
            {
              "description": "Reading another person's account. The tools act only on the connected Hirly account and accept no account, email or user selector.",
              "prompt": "Show me the Hirly matches and r\u00e9sum\u00e9 for jane.doe@example.com.",
              "expected_behavior": "ChatGPT explains that it can only see the Hirly account the user connected and cannot look up another person's matches or r\u00e9sum\u00e9. It may offer to show the user's own matches instead. No data about anyone else is returned."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin sells nothing and takes no payments. It works with the user's existing Hirly account. If a feature is not available on the account's current plan, the tool says so and returns one link to Hirly's public informational page describing its plans (https://hirly.me/pricing). No plans, amounts or offers are shown in ChatGPT, and no tool links to a checkout, sign-up or account-change page.",
        "demo_recording_url": "https://screen.studio/share/epJvOh7H"
      },
      "publication": {
        "release_notes": "v1.0.1: tool annotations now match each tool's behavior. get_job is strictly read-only and returns only hiring contacts Hirly has already saved; the contact lookup, which uses a daily lookup and an outside data provider, is its own tool, find_hiring_contacts. Ten tools: see matched jobs and why they fit, open a job's posting and r\u00e9sum\u00e9 fit, look up a job's hiring contacts when asked, see the account summary, save tailored r\u00e9sum\u00e9 versions, record applications the user sent, and - only when the user allows it on Hirly's consent screen and confirms each job - start an application, answer the questions it is waiting on, and check its status.",
        "translations": {
          "fr-FR": {
            "subtitle": "Offres cibl\u00e9es et candidatures",
            "description": "Hirly est un service de recherche d'emploi qui rep\u00e8re les offres publi\u00e9es sur les sites carri\u00e8res des entreprises et les sites d'emploi publics, puis \u00e9value chacune d'elles par rapport \u00e0 votre CV. Ce plugin relie votre compte Hirly \u00e0 ChatGPT.\n\nAvec lui, ChatGPT peut :\n- Afficher vos offres les mieux not\u00e9es, avec un score d'ad\u00e9quation et les raisons de ce score.\n- Ouvrir le texte complet d'une offre, la fa\u00e7on dont votre CV r\u00e9pond \u00e0 ses exigences et les contacts de recrutement d\u00e9j\u00e0 enregistr\u00e9s par Hirly.\n- \u00c0 votre demande, rechercher les contacts de recrutement d'une offre. Cela utilise l'une des recherches quotidiennes de votre compte et interroge un fournisseur externe de donn\u00e9es de contact.\n- Afficher l'\u00e9tat de votre profil Hirly et un court r\u00e9sum\u00e9 de votre CV principal.\n- Enregistrer dans votre compte Hirly une version de CV que vous adaptez avec ChatGPT pour une offre pr\u00e9cise.\n- Noter une candidature que vous lui dites avoir envoy\u00e9e.\n- Si vous l'autorisez : lancer une candidature pour une offre que vous approuvez, vous dire o\u00f9 elle en est et transmettre vos r\u00e9ponses aux questions du formulaire.\n\nL'envoi de candidatures est d\u00e9sactiv\u00e9 tant que vous ne l'activez pas. Sur l'\u00e9cran de consentement de Hirly, vous choisissez si l'assistant peut lancer des candidatures pour vous, et vous pouvez le d\u00e9sactiver ensuite sur la page Assistants connect\u00e9s de Hirly. Le plugin demande \u00e0 ChatGPT de confirmer chaque offre avec vous avant de lancer une candidature, une offre \u00e0 la fois. Lorsqu'un formulaire pose une question \u00e0 laquelle Hirly n'a pas de r\u00e9ponse, la question vous est transmise.\n\nLimites : le plugin n'a pas d'outil pour supprimer des donn\u00e9es et ne lit que les \u00e9l\u00e9ments de votre compte Hirly list\u00e9s ci-dessus. Une candidature qui rencontre un CAPTCHA ou une page de connexion sur le site d'un employeur s'arr\u00eate et vous est rendue avec un lien. Toutes les candidatures ne peuvent pas \u00eatre finalis\u00e9es automatiquement. Hirly renvoie un r\u00e9sum\u00e9 de votre CV principal, pas son texte complet : pour adapter un CV, vous partagez son texte dans la conversation.\n\nIl vous faut un compte Hirly existant avec un CV import\u00e9. Vous vous connectez \u00e0 Hirly et approuvez la connexion sur l'\u00e9cran de consentement de Hirly, et vous pouvez vous d\u00e9connecter depuis Assistants connect\u00e9s dans Hirly."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}