Use Crazy Egg Skills to help compatible AI agents create or connect an account, install the tracking script, and query Crazy Egg’s API.
Overview
Crazy Egg Skills help compatible AI agents work with Crazy Egg more reliably. Once installed, an AI agent can help with common setup tasks, including creating or connecting a Crazy Egg account, installing the Crazy Egg tracking script, and querying Crazy Egg’s API.
Instead of asking an AI agent to figure out Crazy Egg on its own, Crazy Egg Skills provide structured instructions, helper scripts, and API references so the agent can follow the correct setup steps.
What are Skills?
Skills are reusable instruction packages that help an AI agent perform specific tasks in a consistent way. The Crazy Egg Skills package gives the agent Crazy Egg-specific setup guidance, technical references, and helper commands it can use while working in your environment.
Who this is for
This article is intended for users who want to use an AI agent to help set up Crazy Egg or work with Crazy Egg’s API. It is most useful for:
- Developers installing Crazy Egg in a website, app, or codebase
- Technical marketers setting up tracking with help from an AI agent
- Teams using AI agents to automate setup or API-related workflows
- Users who want to reduce manual copy-pasting during Crazy Egg setup
If you are not using an AI agent, you can still install Crazy Egg manually by copying your Crazy Egg tracking script into the <head> section of your website.
What Crazy Egg Skills can help with
Crazy Egg signup
Helps an AI agent guide you through creating a Crazy Egg account.
Tracking script installation
Helps the agent find the correct place in your website or app to install the Crazy Egg tracking script.
Crazy Egg API access
Helps the agent inspect Crazy Egg’s GraphQL schema and run authenticated API queries using a personal access token.
Before you start
You’ll need:
- A compatible AI agent that supports Skills
- Node.js and npm available in your environment
- A Crazy Egg account, or the ability to create one
- A Crazy Egg personal access token if you want to query Crazy Egg’s API
Install Crazy Egg Skills
In your AI agent environment, install the Crazy Egg Skills package from GitHub:
npx skills add CrazyEggInc/skills
After installation, your AI agent should be able to use Crazy Egg Skills automatically when you ask it to perform Crazy Egg-related tasks.
Connect an existing Crazy Egg account
If you already have a Crazy Egg account, you can ask your AI agent:
Use my existing Crazy Egg account to install Crazy Egg on this website.The agent may ask for a Crazy Egg personal access token so it can retrieve account-specific details, such as your tracking script URL.
You can create a personal access token from your Crazy Egg account settings:
https://auth.app.crazyegg.com/settings
Copy the token and provide it to your agent when asked. Crazy Egg personal access tokens begin with:
ce_pat_Sign up for a new Crazy Egg account
If you do not have a Crazy Egg account yet, you can ask your agent:
Sign me up for Crazy Egg and install it on my site.
The agent can help open the correct Crazy Egg signup flow and may prefill details such as your email, name, and website when available.
Install the Crazy Egg tracking script
Once your account is connected, you can ask:
Install the Crazy Egg tracking script in this project.
The agent will look for the shared layout, document shell, or template that controls the <head> section of your site. It will then add the Crazy Egg tracking script in the correct location so it loads across your website.
Crazy Egg Skills help the agent avoid common setup issues, such as:
- Installing the script on only one page
- Adding duplicate Crazy Egg scripts
- Guessing the wrong tracking script URL
- Placing the script somewhere that does not load site-wide
Query Crazy Egg with an AI agent
With a personal access token, your agent can query Crazy Egg’s API.
For example, you can ask:
Show me my Crazy Egg account details.Or:
Query Crazy Egg and tell me whether my account is authenticated.The agent uses the GraphQL API references included in the Crazy Egg Skills package to understand available fields and run the correct authenticated queries.
Best practices
- Only use personal access tokens with AI agents and environments you trust.
- Do not paste personal access tokens into public chats, shared documents, or public repositories.
- Install the Crazy Egg tracking script in a shared site layout, not an individual page.
- Ask the agent to verify that the script was added only once.
- If your site has separate staging and production environments, make sure the production URL is used for your Crazy Egg setup.
- If your site uses a framework such as React, Next.js, Shopify, Webflow, or WordPress, ask the agent to confirm where global scripts should be added before making changes.
Troubleshooting
The agent cannot find where to install the script
Ask the agent to identify the shared layout, document shell, theme file, or template that controls the <head> section of your site. The tracking script should be installed in a site-wide location, not on a single page.
The agent asks for a personal access token
This may be required when the agent needs to retrieve account-specific details or query Crazy Egg’s API. Create the token from your Crazy Egg account settings, then provide it only in a trusted environment.
The tracking script was added more than once
Ask the agent to search the project for existing Crazy Egg scripts and remove duplicates. The Crazy Egg tracking script should only be installed once per page.
Summary
Crazy Egg Skills make it easier for AI agents to help with Crazy Egg setup. They give the agent the context it needs to create or connect an account, install the tracking script, and query Crazy Egg’s API with fewer manual steps and fewer setup mistakes.
Once installed, you can ask your AI agent to handle common Crazy Egg setup tasks directly from your development environment.