> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use your AI tool with the Hireflix skill

> Give your AI tool the Hireflix skill file and your API key, and ask it to work with the Hireflix API in plain English.

## What is this?

Hireflix publishes a **skill file** at [hireflixsl.mintlify.app/skill.md](https://hireflixsl.mintlify.app/skill.md). It contains everything your **AI tool** needs to talk to the Hireflix API directly: the GraphQL schema and example queries. Once you provide your API key, you can ask it to do things in plain English instead of writing GraphQL yourself. That includes **building a position from scratch** (name, questions, video or image prompts, intro/outro) just by filling in a short template in chat.

We've tested the skill with **Claude**, **ChatGPT / Codex**, and **Gemini** (only via the Google Antigravity desktop app). We recommend Claude, as it works best with Hireflix.

> [!TIP]
>
> **Not sure whether you need the skill?** Most people are better off with the [Hireflix MCP](https://docs.hireflix.com/ai/mcp.md): you sign in with your Hireflix account instead of pasting an API key. See [MCP or skill?](https://docs.hireflix.com/ai/overview.md#mcp-or-skill) for when the skill is the better fit.

**Quick path:**

1. [Complete setup](#setup): add the skill to your AI tool.
2. [Create a position via chat](https://docs.hireflix.com/ai/guides/create-position-via-chat.md): fill in the position template, your AI tool builds it.
3. [Explore your account](#explore-your-account): ask about positions, stats, and interview results.

> [!NOTE]
>
> You'll need a Hireflix **API key** to use the skill. If you don't have one yet, follow the [Quickstart](https://docs.hireflix.com/tech/quickstart.md) to create an account and generate a key. In Claude, you'll also need to allow the Hireflix websites (see setup below) **before** starting your chat session.

## Setup

Choose your AI tool and follow the steps. Each tool also has its own page in the [AI tools](https://docs.hireflix.com/ai/tools/claude.md) section.

> [tab] Claude (recommended)
>
> **1. Allow the Hireflix websites in Claude**
>
> In Claude, click your account name and open **Settings → Capabilities**. Under **Create and edit files**, make sure **Use the internet while making files** is turned on. Then click **Manage** next to **Allowed websites**.
>
> ![The Capabilities page in Claude settings with Use the internet while making files turned on and the Manage button next to Allowed websites](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-capabilities-allowed-websites.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=64381b1776b3bf72016eb7fd19e14085)
>
> Leave **Which sites to allow** on **Standard download sites only**. Then add each of the following websites before you start a new chat: type it in the **Add a website** field and click **Add**.
>
> * `api.hireflix.com` — the GraphQL API endpoint Claude talks to for every query and mutation.
>
> * `media.hireflix.com` — where signed video playback URLs resolve; needed whenever Claude fetches or plays back an interview video.
>
> * `com-hireflix-production-media.s3-accelerate.amazonaws.com` — the signed S3 URL Hireflix issues for video uploads (intro, outro, or per-question videos).
>
> * `images.hireflix.com` — where uploaded question images are served; needed whenever Claude fetches or shows you an image from an image prompt question. (Uploading an image goes through `api.hireflix.com`, so it doesn't need this domain.)
>
> > [!WARNING]
> >
> > Missing one of these websites can cause requests to silently fail partway through a task (e.g. Claude can create a position but can't upload the video you attached). Add all four now to avoid troubleshooting it later.
>
> ![The Allowed websites page in Claude settings with the Add a website field and the Hireflix websites in the list](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-allowed-websites-add.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=84cb808e38464de08a560bd72acc1956)
>
> **2. Get the Hireflix skill file**
>
> Open [hireflixsl.mintlify.app/skill.md](https://hireflixsl.mintlify.app/skill.md) and save the page as `skill.md`. You can hit `CTRL + S` or on Mac `CMD + S` to store the page as `skill.md` on your machine.
>
> **3. Upload the skill to Claude**
>
> In Claude, click your account name and open **Settings**. Click **Customize** in the left menu and open the **Skills** tab. Then click the **Add** button in the top right and choose **Upload skill**.
>
> ![The Skills tab under Settings > Customize with the Add menu open, showing Upload skill](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-skills-add.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=910cfbb3d72ef49f52c622f35762469d)
>
> Drag the `skill.md` file you just saved into the **Skill file** box (or click it to browse for the file), then click **Upload**. Claude runs a security scan on the skill when you upload it.
>
> ![The Upload a skill page in Claude settings with the Skill file drop zone and the Upload button](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-skill-upload-file.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=9a3cc80aa3073e10d2c68c595079134c)
>
> **4. Start a new chat and add your API key**
>
> Start a **new** chat (so the allowed websites from step 1 apply), and give Claude your Hireflix API key so it can authenticate against `api.hireflix.com`. See the [Quickstart](https://docs.hireflix.com/tech/quickstart.md) if you still need to create one.
>
> > [!WARNING]
> >
> > When sharing an API key with Claude AI, make sure to revoke it after your session has ended as a safety precaution.

> [tab] ChatGPT / Codex
>
> ChatGPT and Codex use the same interface, so these steps work for both.
>
> > [!WARNING]
> >
> > **ChatGPT is known to be less reliable with MCP servers and skills than Claude.** What to expect:
> >
> > * **Large results:** asking for a lot of data at once (for example, every interview across all positions) can make ChatGPT stall or cut the answer short. Ask for smaller chunks, such as one position or the latest 10 interviews.
> > * **Slow responses:** requests can take noticeably longer, and sometimes time out.
> > * **Skipped or wrong tool calls:** ChatGPT sometimes answers without using Hireflix, or guesses the wrong fields. Tagging **Hireflix** and asking step by step helps.
> >
> > If you keep running into these issues, try Claude instead.
>
> > [!NOTE]
> >
> > You need a ChatGPT **Business**, Enterprise, or Edu plan to use the Hireflix skill.
>
> **1. Start creating a skill**
>
> Click **Customize** in the left menu (1), then **Skills** (2). Click the **Add** button in the top right (3) and choose **Create skill** (4). This opens a new chat with **Skill Creator** tagged.
>
> > [!NOTE]
> >
> > You might already see **Hireflix** under **Installed** in the left menu. That's the plugin from the [MCP tutorial](https://docs.hireflix.com/ai/mcp.md), not the skill.
>
> ![The Skills page under Customize with the Add menu open, showing Create skill](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skills-create-skill.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=eb6960e558a413c21b804739b6345e4b)
>
> **2. Paste the skill file and send the instruction**
>
> Open [hireflixsl.mintlify.app/skill.md](https://hireflixsl.mintlify.app/skill.md), copy the full contents, and paste them into the chat. They pop up as an attached file (1).
>
> Prefer working with a file? Save the page as `skill.md` with `CMD + S` on Mac or `CTRL + S` on Windows, then attach that file to the chat instead. Copying the contents directly is usually easier.
>
> > [!WARNING]
> >
> > Add the contents of the file. Using the direct link to `skill.md` doesn't work.
>
> Then add this instruction and send your message (2):
>
> ```text theme={null}
> Can you create a skill for Hireflix based on the attached skill.md file
> ```
>
> ![A new chat with Skill Creator tagged, the pasted skill file attached, and the instruction typed in the message box](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-paste-file.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=b3db790a16c138cf2ffaf2483fba7444)
>
> **3. Wait for the skill to be created**
>
> Creating the skill takes around 30 seconds to a minute. ChatGPT tells you when the Hireflix skill is created and installed.
>
> ![ChatGPT confirming that it created and installed the Hireflix skill](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-created.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=236d22490c202f60339b6d7ffd371327)
>
> **4. Open the skill**
>
> Go back to **Customize → Skills**, find **Hireflix** in the **Installed** list on the page, and click it.
>
> ![The Skills page with the Hireflix skill highlighted in the Installed list](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skills-list.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=b2ec520cd7c1def54226999cabb5dcdf)
>
> **5. Click Try now**
>
> Click **Try now**. This opens a new chat with the Hireflix skill already tagged.
>
> ![The Hireflix skill details with a Try now button](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-try-now.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=4231725ba6ead624c8f396c97f5cfcc5)
>
> **6. Add your API key and ask a question**
>
> You can now ask anything. With the skill tagged (1), give it your Hireflix API key the first time you use it (2). See the [Quickstart](https://docs.hireflix.com/tech/quickstart.md) if you still need to create one. For example:
>
> ```text theme={null}
> Can you show all positions in my account? Here's my API key: <key>
> ```
>
> ![A new chat with the Hireflix skill tagged and a question that includes an API key placeholder](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-api-key-prompt.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=a88a3046cf7d0193cbb3e03eed2b72d8)
>
> ChatGPT uses the skill to answer your question:
>
> ![ChatGPT listing six positions and reminding you to rotate the API key you pasted](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-demo.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=f01354b066e6c56aa7139cbe9f208613)
>
> > [!WARNING]
> >
> > When you're done chatting, don't forget to rotate your key in your [API keys settings](https://admin.hireflix.com/en/my-account/api-keys).

> [tab] Gemini (Antigravity)
>
> > [!WARNING]
> >
> > This **only works in Google Antigravity**, Google's desktop app for working with Gemini. It doesn't work in the Gemini web app at [gemini.google.com](https://gemini.google.com). A regular Google account is enough; you don't need a paid Google Workspace subscription.
>
> > [!TIP]
> >
> > **We recommend the [Hireflix MCP](https://docs.hireflix.com/ai/mcp.md) over the skill in Antigravity.** The skill works, but it's a lot slower: Gemini first has to explore the Hireflix GraphQL schema and asks for permission at almost every step. With the MCP, you don't need an API key either.
>
> **1. Download Google Antigravity**
>
> Download and install Google Antigravity from [antigravity.google/download](https://antigravity.google/download), open it, and sign in with your Google account.
>
> **2. Start creating a plugin**
>
> In Antigravity, the skill becomes a **plugin**. Click **Customizations** in the left menu (1) and switch to **Installed** in the top right (2). In the **Plugins** section at the top, click **+ Create** (3). This opens a new chat with **plugin** tagged, where Antigravity's agent builds the plugin for you.
>
> ![The Customizations page in Antigravity with the Installed tab selected and the Create button in the Plugins section](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-plugin-create.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=e363b34c267a1111870a35b00c62b5e9)
>
> **3. Optional: switch to Turbo mode**
>
> Creating the plugin takes a while, and Antigravity asks for permission to run a lot of commands along the way. If you don't want to approve each one, click the permissions menu next to the send button (it says **Default**) (1) and choose **Turbo** (2). Antigravity then runs all commands without asking.
>
> > [!WARNING]
> >
> > Turbo mode lets the agent run any command on your computer without asking first. Use it at your own risk, and switch back to **Default** when you're done.
>
> ![The Local Permissions menu in Antigravity with the options Request Review, Default, Auto, and Turbo](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-permissions-turbo.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=a7bd459bc412a791aaf767e1c598d4e3)
>
> **4. Ask Antigravity to create the plugin from the skill file**
>
> Replace the suggested text with this instruction, which includes the link to the Hireflix skill file, and send it (1):
>
> ```text theme={null}
> Create a plugin based on this skill.md file: https://hireflixsl.mintlify.app/skill.md
> ```
>
> ![The plugin chat in Antigravity with the instruction to create a plugin based on the Hireflix skill.md URL](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-plugin-prompt.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=d0748f4a545f6cce620c3f563eef0f9e)
>
> Antigravity now works through a long series of steps to build the plugin. If you're not in Turbo mode, approve each permission request when it asks.
>
> **5. Check that the plugin is installed**
>
> When Antigravity is done, go back to **Customizations → Installed**. **Hireflix** now appears in the **Plugins** list.
>
> **6. Add your API key and ask a question**
>
> Click **New Conversation**, type `@`, and pick the **Hireflix** plugin (1). Then ask your question and give it your Hireflix API key (2). See the [Quickstart](https://docs.hireflix.com/tech/quickstart.md) if you still need to create one. For example:
>
> ```text theme={null}
> Can you list all positions in my account? Here's my API key: <key>
> ```
>
> > [!NOTE]
> >
> > Also connected the [Hireflix MCP](https://docs.hireflix.com/ai/mcp.md)? Make sure you pick the **Hireflix plugin** here, not the `hireflix` MCP server.
>
> ![A new conversation in Antigravity with the Hireflix plugin tagged and a question that includes an API key placeholder](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-skill-api-key-prompt.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=bafa88b8a3f473ebac5e5d9fb2d26a17)
>
> Expect more permission requests here too: Gemini introspects the Hireflix GraphQL schema to find the right query before it runs it. You can approve them one by one, or switch to Turbo mode at your own risk (see step 3). This makes the skill noticeably slower than the MCP.
>
> > [!WARNING]
> >
> > When you're done chatting, don't forget to rotate your key in your [API keys settings](https://admin.hireflix.com/en/my-account/api-keys).

## Explore your account

With your API key set for the session, start with a simple question:

```text theme={null}
Can you help me list all positions for Hireflix in my account?
```

Your AI tool uses the schema and examples from the skill file to write and run the right GraphQL queries against your account behind the scenes.

![Example Claude conversation using the Hireflix skill to list positions and interview stats](https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-demo.png?fit=max\&auto=format\&n=Ypm7QQvPzDIYtdD0\&q=85\&s=c033fa0bd83e84c562e38f5eab5fad86)

Claude's response after being asked to list all positions

Once that works, try the [example prompts](https://docs.hireflix.com/ai/guides/example-prompts.md) for interview stats, review queues, exports, and more.

## What's next?

> [card] [Create a position via chat](https://docs.hireflix.com/ai/guides/create-position-via-chat.md)
>
> Fill in one template and let your AI tool build the whole position, including videos and images.

> [card] [Use the Hireflix MCP](https://docs.hireflix.com/ai/mcp.md)
>
> Connect your AI tool to your Hireflix account with the MCP server: no API key needed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.