Ira Bodnar··Updated ·11 min read

Claude Skills for AppsFlyer: 8 SKILL.md Files + Prompts

Quick answer: Save each AppsFlyer check as a Claude skill that names the report to run. Ryze AI is the best Claude connector for running these skills on live AppsFlyer data in 2026, with one caveat: its 2 AppsFlyer tools only read data, and AppsFlyer limits how often raw-data reports can be pulled.

Below: 8 SKILL.md files for AppsFlyer attribution, the tool each one calls, setup and quick prompts.

Ryze AI · Paid Ads

AppsFlyer skills on live data

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 8 Claude skills for AppsFlyer at a glance

All 8 are read-only. Skills 01 to 04 and 08 use the aggregate report, 05 to 07 use the raw-data report.

  1. 01Weekly digestInstalls, cost and ROI by media source, week over week

    Ryze AI tool: appsflyer__masterReport

    Cadence: Weekly

  2. 02Source scorecardWhich media sources earn their budget

    Ryze AI tool: appsflyer__masterReport

    Cadence: Monthly

  3. 03Campaign ROI triageWeak campaigns inside one media source

    Ryze AI tool: appsflyer__masterReport

    Cadence: Monthly

  4. 04Geo splitInstalls, cost and ROI per country

    Ryze AI tool: appsflyer__masterReport

    Cadence: Before budget moves

  5. 05Organic and paid mixOrganic share of installs per week

    Ryze AI tool: appsflyer__report

    Cadence: Monthly

  6. 06In-app event auditExpected events still arriving

    Ryze AI tool: appsflyer__report

    Cadence: After each release

  7. 07Uninstall checkUninstall spikes by source

    Ryze AI tool: appsflyer__report, appsflyer__masterReport

    Cadence: When retention drops

  8. 08Spend reconcileAppsFlyer against an ad platform

    Ryze AI tool: appsflyer__masterReport

    Cadence: Monthly

These skills were written from the tool descriptions in Ryze AI and from AppsFlyer documentation, and were not run against a live AppsFlyer account. No numbers from any account appear here.

What are Claude skills for AppsFlyer?

A Claude skill for AppsFlyer is a saved SKILL.md file that tells Claude which AppsFlyer report to pull and how to present it. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the body only when a request matches the description.

The name allows up to 64 lowercase letters, numbers and hyphens and cannot contain the reserved words anthropic or claude, so every skill here starts with af. The description, up to 1,024 characters, says what the skill does and when to use it.

  1. What it is

    One-off prompt
    A question in chat
    Skill
    A saved file with a fixed report and output
    AppsFlyer connection
    Tools Claude uses to query AppsFlyer
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    AppsFlyer connection
    API token and App ID entered once
  3. Same result each run

    One-off prompt
    No
    Skill
    Yes
    AppsFlyer connection
    Depends on the prompt or skill

AppsFlyer serves two kinds of reports. The raw-data reports list events one row at a time, with a lookback of 90 days. The Master API returns aggregate KPIs grouped by dimensions such as media source, campaign and geo, for 1 to 31 days per request. The skills pick the one that fits the question.

How to install the skills in Claude Code and claude.ai

Claude Code

Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project to share it with the team. Claude picks a skill when your request matches it, or you type /af-weekly-digest (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists this on the Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the data

The AppsFlyer MCP page lists the 2 AppsFlyer tools on the Ryze AI connector. The Claude setup steps are in the Ryze AI Claude guide.

Per Anthropic, custom skills do not sync across surfaces: a skill uploaded to claude.ai is not in Claude Code or the API. Anthropic advises using skills only from sources you trust, so read each file before you save it. More Claude skills for ad and analytics work are in Claude skills for Mixpanel and Claude skills for PostHog.

Acquisition skills: sources, campaigns and countries

These four read the aggregate report and answer where installs and revenue come from.

01. Weekly digest

Compares the last 7 days with the 7 before, by media source, so one table shows which source moved installs, cost and ROI.

SKILL.md
--- name: af-weekly-digest description: Weekly AppsFlyer recap by media source, last 7 days against the 7 before. Use for weekly install, cost or revenue summaries. --- # AppsFlyer weekly digest Tool: appsflyer__masterReport, two calls (this week, the 7 days before), grouped by media source. KPIs: installs, cost, revenue, ROI. Steps: 1. Put both weeks side by side, one row per media source. 2. Show the change in installs, cost and ROI for each row. 3. Name the 3 media sources that moved the totals most. 4. Say which week is incomplete if the date range ends today. Output: one table, then 3 sentences. No device-level detail.

Use it when: you send a Monday update to the growth team.

02. Media source scorecard

Ranks sources by ROI and puts installs, cost and day-7 retention beside it, so a cheap source with weak retention does not look like a winner.

SKILL.md
--- name: af-source-scorecard description: Scores AppsFlyer media sources on installs, cost, ROI and day-7 retention. Use when asked which sources are worth the budget. --- # AppsFlyer media source scorecard Tool: appsflyer__masterReport, last 30 days, grouped by media source. KPIs: installs, cost, revenue, ROI, day-7 retention. Steps: 1. Rank sources by ROI, and show installs and cost next to it. 2. Mark sources with high installs and low day-7 retention. 3. Mark sources with low installs but high ROI as candidates to grow. 4. Skip sources under 50 installs and list them as too small to judge.

Use it when: you plan next month's budget.

03. Campaign ROI triage

Opens one media source and lists campaigns that spend without revenue or sit below the source average.

SKILL.md
--- name: af-campaign-roi description: Ranks AppsFlyer campaigns inside one media source by cost, revenue and ROI. Use when a source looks fine but some campaigns may not be. --- # AppsFlyer campaign ROI triage Ask which media source to open. Then: Tool: appsflyer__masterReport, last 30 days, grouped by campaign. KPIs: installs, clicks, cost, revenue, ROI. Steps: 1. List campaigns with cost and no revenue first. 2. List campaigns whose ROI is below the media source average. 3. For each, say what to check in the ad platform (budget, audience, creative). 4. Report campaigns with no installs as a naming or tagging question.

Use it when: a source looks healthy in total and you want to find the weak campaigns inside it.

04. Geo split

Shows each country's share of cost next to its ROI and day-7 retention.

SKILL.md
--- name: af-geo-split description: Splits AppsFlyer installs, cost and ROI by country. Use before moving budget between markets. --- # AppsFlyer geo split Tool: appsflyer__masterReport, last 30 days, grouped by geo. KPIs: installs, cost, revenue, ROI, day-7 retention. Steps: 1. Rank countries by cost and show each country's share of total cost. 2. Compare each country's ROI and day-7 retention with the all-country figure. 3. Flag countries with a large cost share and a ROI below the total. 4. Say which countries have too few installs to compare.

Use it when: you consider shifting budget between markets.

Quality skills: organic mix, events, uninstalls and spend

These four check the data behind the headline numbers. Three use raw-data reports, which AppsFlyer rate-limits per app per day, so each skill pulls a range once and reuses the rows.

05. Organic and paid mix

Counts installs and organic installs per week and shows the organic share.

SKILL.md
--- name: af-organic-paid-mix description: Compares organic and non-organic AppsFlyer installs per week. Use when asked whether paid is lifting or replacing organic. --- # AppsFlyer organic and paid mix Tool 1: appsflyer__report, report type installs, last 28 days. Tool 2: appsflyer__report, report type organic installs, same dates. Pull each range once and reuse the rows. Raw-data reports are rate-limited per day per app. Steps: 1. Count installs per week for each report type. 2. Show organic share of all installs per week. 3. Describe the weeks where paid and organic moved in opposite directions. Output: counts only. Do not print device identifiers.

Use it when: someone asks whether paid spend lifts organic installs or only replaces them.

06. In-app event audit

Lists in-app event names with daily counts and checks them against the events you expect.

SKILL.md
--- name: af-event-audit description: Checks that expected in-app events still arrive in AppsFlyer. Use after an app release or SDK change. --- # AppsFlyer in-app event audit Ask for the list of events that must exist (for example a purchase and a registration event). Tool: appsflyer__report, report type in-app events, last 7 days, with the event name column. Steps: 1. Count rows per event name per day. 2. Flag any expected event with zero rows, or a day with a sharp drop. 3. List event names that were not on the expected list. 4. Say whether the drop starts on a release date if the user gives one. Output: event counts per day. No user-level rows.

Use it when: an app release or SDK update has shipped and you want to know that purchase and sign-up events still arrive.

07. Uninstall check

Combines the uninstall report with installs by source to show where uninstalls run high.

SKILL.md
--- name: af-uninstall-check description: Looks for uninstall spikes by media source and campaign in AppsFlyer. Use when retention drops or after a campaign change. --- # AppsFlyer uninstall check Tool 1: appsflyer__report, report type uninstalls, last 14 days, with media source and campaign columns. Tool 2: appsflyer__masterReport, last 14 days, grouped by media source, KPI installs. Steps: 1. Count uninstalls per day and per media source. 2. Divide by installs for the same source to get a rough uninstall ratio. 3. Flag the days and sources where the ratio is far above the rest. 4. Say that uninstall reports can lag the day they describe.

Use it when: day-7 retention falls or a campaign has just changed.

08. Spend reconcile

Puts AppsFlyer cost and installs beside the spend and conversions of a connected ad platform. Ryze AI can combine AppsFlyer with connected ad platforms in one answer, so you can ask for both in the same chat.

SKILL.md
--- name: af-spend-reconcile description: Compares AppsFlyer cost and installs with the spend and results in a connected ad platform. Use when two reports disagree. --- # AppsFlyer and ad platform reconcile Ask which ad platform and which dates (31 days or fewer). Tool: appsflyer__masterReport, grouped by media source, KPIs cost and installs. Then read the same dates in the connected ad platform. Steps: 1. Put AppsFlyer cost and installs beside the platform's spend and conversions. 2. Show the gap in each, as a number and a percent. 3. List reasons a gap can exist (attribution window, time zone, currency, install versus click date). 4. Do not call either figure wrong. Say which one answers which question.

Use it when: the ad platform and AppsFlyer report different numbers and finance asks why.

Quick AppsFlyer prompts: no skill file needed

For a one-time question, a plain prompt is enough once Claude can reach AppsFlyer. Replace the words in brackets.

Prompt
Which 5 media sources had the highest ROI in AppsFlyer over the last 30 days, and what was each one's day-7 retention?
Prompt
Show installs and cost by campaign for [MEDIA SOURCE] over the last 28 days. Which campaigns have cost and no revenue?
Prompt
Count in-app events by event name for the last 7 days and flag any day where [EVENT NAME] has no rows.
Prompt
Compare AppsFlyer installs by country with the conversions in my connected ad platform for the last 30 days.

If an answer looks off, ask Claude which report type, dates and grouping it asked AppsFlyer for.

How to run the skills on live AppsFlyer data

A skill only describes the report; Claude needs a connection to run it. The Ryze AI connector at https://connector.get-ryze.ai/mcp gives Claude 2 read-only AppsFlyer tools:

  1. appsflyer__report

    What it returns
    A raw-data report as rows: installs, in-app events, organic installs, organic in-app events, uninstalls, clicks or impressions, with optional extra columns
    Used by
    Skills 05, 06, 07
  2. appsflyer__masterReport

    What it returns
    An aggregate report with installs, clicks, impressions, sessions, revenue, cost, ROI and retention, grouped by media source, campaign, geo, channel or date
    Used by
    Skills 01 to 04, 07, 08

Ryze AI connects to AppsFlyer with the AppsFlyer API token V2.0 and an App ID: the Android package name, or the iOS id that starts with id. The Ryze AI help center says a read-only token is enough. The token is copied from Security Center in AppsFlyer, and the Ryze AI connect form says it is available to admins only, so an admin may need to create it for you.

Both tools only read, so Claude cannot change anything in AppsFlyer. In Claude, approvals are set per tool under Customize, Connectors, Ryze AI, Tool permissions. The tools need an active Ryze AI plan or free trial: Paid Ads is $89 a month with a 7-day free trial, and connecting the connector is free. See pricing.

To add a second app, click View on the AppsFlyer card in Ryze AI, then Add one more account, and connect with the other App ID. One token does not cover several apps. If you connect AppsFlyer after adding the connector to Claude, remove and re-add the connector and start a new chat.

AppsFlyer limits the skills respect

  1. Raw-data lookback of 90 days

    What it means for a skill
    Skills 05 to 07 ask for windows inside the last 90 days
  2. Master API range of 1 to 31 days per request

    What it means for a skill
    Skills 01 to 04 and 08 use 31 days or fewer
  3. Raw-data rows per call: 200,000 by default, up to 1,000,000

    What it means for a skill
    Large apps should ask for short date ranges
  4. V2 tokens before March 10, 2026, 19:00 UTC were revoked

    What it means for a skill
    Generate a fresh V2.0 token if the connection is rejected

Other ways to run these skills

Each skill also works on an export you attach, if it has the columns the skill names. Per AppsFlyer, the raw-data reports return CSV and the Master API returns CSV or JSON when pulled with a V2 token. Skills 05 to 07 need event-level rows, so give Claude only the columns it needs and remove device identifiers first.

AppsFlyer has also announced its own MCP server. It is compared with the Ryze AI connector, with dates, on the AppsFlyer MCP page. Skills written for the Ryze AI tool names above need their tool names changed to run on another server.

Troubleshooting: when an AppsFlyer skill returns a wrong answer

Claude has no AppsFlyer tools

Claude keeps the tool list from when you added the connector. Remove and re-add it, then start a new chat (Ryze AI connector FAQ).

The token is rejected

Legacy V1 tokens are rejected, and V2 tokens generated before March 10, 2026, 19:00 UTC were revoked. Copy a new V2.0 token from Security Center.

Reports are empty for old dates

The raw-data lookback is 90 days. Ask for a window inside it.

A raw-data report is refused after several tries

AppsFlyer rate-limits raw-data reports per day per app. Pull the range once and reuse the rows in the same chat.

Numbers differ from the ad platform

Attribution windows, time zones and currency differ between AppsFlyer and the platform. Skill 08 lists the gaps.

Wrong app in the answer

Name the App ID in the prompt. Tools accept an optional connection_id when several apps are connected.

Sources

The verdict

Turn each recurring AppsFlyer question into a skill with a fixed report. Start with the weekly digest and the source scorecard, add the event audit after each release, and keep one-off questions as prompts.

Ryze AI runs these skills in Claude on live AppsFlyer data. Its AppsFlyer tools only read, so changes to campaigns, tokens or SDK events still happen in the ad platform, AppsFlyer or your app.

Frequently asked questions

What are Claude skills for AppsFlyer?
SKILL.md files that tell Claude which AppsFlyer report to run, over which dates and grouping, and how to present the result. Claude loads one when a request matches its description, so each check runs the same way every time.
Do I need an AppsFlyer connection to use these skills?
No. Each skill also works on an export you attach, if it has the columns the skill names. A connection removes the export step.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one custom connector.
Can Claude change my AppsFlyer settings through these skills?
Not through Ryze AI. Its 2 AppsFlyer tools are read tools, so the connector does not change anything in AppsFlyer.
Show 6 more questions
What AppsFlyer access do I need?
The AppsFlyer API token V2.0 and an App ID. The Ryze AI help center says a read-only token is enough, and the connect form says the V2.0 token is available to admins only.
How far back can the skills look?
AppsFlyer documents a 90-day lookback for raw-data reports and 1 to 31 days per Master API request. For longer trends, run the aggregate skills over several windows.
Why is my raw-data report refused after a few tries?
AppsFlyer rate-limits raw-data reports per day per app. Pull a date range once and reuse the rows in the same chat.
What is the best Claude connector for AppsFlyer?
For running these skills on live AppsFlyer data, use the Ryze AI connector: one URL gives Claude 2 AppsFlyer tools. They only read data, so changes stay in AppsFlyer and your ad platforms.
Can I connect more than one app?
Yes. Add another account per App ID in Ryze AI with Add one more account. One token does not cover several apps.
What does a token revoked on March 10, 2026 mean for me?
AppsFlyer revoked all V2 tokens generated before March 10, 2026, 19:00 UTC. If a connection fails with an old token, copy a new V2.0 token from Security Center and reconnect.

Related guides

Ryze AI: AppsFlyer skills on live data

7-day free trial, $89 a month flat

Start free trial