Alma agent skills for Claude Code, Cursor and RevampKey

3 ready-made playbooks that teach an AI agent how to do real Alma work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Alma

Connect Alma once and all 3 skills install themselves and stay up to date. Mac, Windows and Linux.

All 3 Alma skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereRead-only5 Alma tools

Use Alma nutrition data with AI

Lets your AI assistant answer questions about your own Alma meals, Alma Score, goals, weight history and profile. It confirms whose account it is reading first and asks before changing anything.

Use it when

You want to ask how your meals this week relate to your Alma Score
You need to check which goals you have set in Alma
You are reconnecting Alma or getting a permission error

Tools it uses

get_user_profile
get_meal_data
get_alma_score_data
get_goals
get_weight_history

Example

Look at my Alma meals and score for the last two weeks and tell me what seems to be pulling my score down.

Your profile is Sam Okafor, so I'm reading that account. Over the last 14 days you logged 42 meals on 12 of 14 days. Your Alma Score moved from 61 to 68, and the biggest drop was on the two days with no logged meals. Two days without logs means those days can't be read as low intake.

Use in RevampKeyRead the full skill →

Read-only5 Alma tools

Check your Alma goal progress

Lines up your Alma goals with your weight history and meal logs, then tells you which goals are on track, drifting, or can't be judged yet because data is missing. It reads only and never changes your goals or logs.

Use it when

You want to know if you're on track for a weight goal by its target date.
A goal feels stalled and you want to see whether the data agrees.
You want to see which goals have too little logged data to judge.

Tools it uses

get_user_profile
get_goals
get_weight_history
get_meal_data
get_alma_score_data

Example

Am I on track for my goals over the last 8 weeks?

Your protein goal is drifting: 9 of 22 logged days met your target, and the last two weeks are below the earlier pace. Your weight goal is on track: 4 weigh-ins over 8 weeks show a steady downward trend that reaches your target by the set date. Your vegetables goal can't be assessed yet because meals were logged on only 3 days.

Use in RevampKeyRead the full skill →

Read-only3 Alma tools

Review your meals against your Alma Score

Looks back over a chosen period of your logged meals and Alma Score to describe what lined up with the score moving. It describes your data only and does not give medical advice.

Use it when

You want to know why your Alma Score dropped or rose this week
You are looking back over the last two or four weeks of eating and score
You want to see which logged meals or timing patterns coincided with score changes

Tools it uses

get_user_profile
get_alma_score_data
get_meal_data

Example

Why did my Alma Score drop last week? Compare it with the week before.

Your score fell from 74 to 66 between 3 and 9 March, compared with the week before. Most of the drop came on 5 and 6 March, when your logged meals were mostly after 9pm and you logged only two meals on 6 March. I rate the late-meal pattern as plausible, since it fits those two days but not the whole week. Logging was lower on 6 March, so part of the drop may reflect missing data rather than food.

Use in RevampKeyRead the full skill →

Get all 3 without copying a file

RevampKey adds the skills when you connect Alma, updates them for you and removes them when you disconnect.

Download RevampKey

How Alma skills work

Connect Alma
The Alma MCP server gives the agent its tools.
Ask in plain words
“Am I on track for my goals over the last 8 weeks?” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Alma skills

In RevampKey the skills install themselves when you connect Alma. In other tools each skill is one folder with a SKILL.md file, and you also need the Alma MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Alma. All 3 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Am I on track for my goals over the last 8 weeks?”
Download RevampKeyConnect Alma · 1 click
Get RevampKey to connect Alma
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Alma is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials goal-progress-check meal-and-score-review; do curl -fsSL --create-dirs -o .claude/skills/alma-$s/SKILL.md https://revampkey.com/marketplace/alma/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Alma MCP server in Claude Code.

Run this in your project folder to add all 3 skills:

for s in essentials goal-progress-check meal-and-score-review; do
  curl -fsSL --create-dirs -o .claude/skills/alma-$s/SKILL.md https://revampkey.com/marketplace/alma/skills/$s/SKILL.md
done

Ask in plain language, for example “Am I on track for my goals over the last 8 weeks?”

Into the shared .agents/skills folder

Connect the Alma MCP server in Cursor.

Run this in your project folder to add all 3 skills:

for s in essentials goal-progress-check meal-and-score-review; do
  curl -fsSL --create-dirs -o .agents/skills/alma-$s/SKILL.md https://revampkey.com/marketplace/alma/skills/$s/SKILL.md
done

Ask in plain language, for example “Am I on track for my goals over the last 8 weeks?”

Into the shared .agents/skills folder

Connect the Alma MCP server in Codex.

Run this in your project folder to add all 3 skills:

for s in essentials goal-progress-check meal-and-score-review; do
  curl -fsSL --create-dirs -o .agents/skills/alma-$s/SKILL.md https://revampkey.com/marketplace/alma/skills/$s/SKILL.md
done

Ask in plain language, for example “Am I on track for my goals over the last 8 weeks?”

Into the shared .agents/skills folder

Connect the Alma MCP server in VS Code.

Run this in your project folder to add all 3 skills:

for s in essentials goal-progress-check meal-and-score-review; do
  curl -fsSL --create-dirs -o .agents/skills/alma-$s/SKILL.md https://revampkey.com/marketplace/alma/skills/$s/SKILL.md
done

Ask in plain language, for example “Am I on track for my goals over the last 8 weeks?”

RevampKey or copy the files?

In RevampKey

One click when you connect Alma
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Alma MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Alma skills FAQ

What is a Alma agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Alma skill describes one job, which Alma tools to use in which order, what to check first and when to stop and ask you.

Do the Alma skills change anything on their own?

3 of the 3 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Alma.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Alma; elsewhere you copy the folders into your project or skills directory.

Do I need the Alma MCP server too?

Yes. The skills tell the agent how to do the work; the Alma MCP server gives it the tools to do it. The Alma MCP setup guide covers every client.

Alma MCP server setup · This page as Markdown

Put Alma’s best workflows in your agent

Download RevampKey, connect Alma and ask your first question in about a minute.

Download RevampKey Connect Alma · 1 click

All 3 Alma skills

Use Alma nutrition data with AI

Use it when

Tools it uses

Check your Alma goal progress

Use it when

Tools it uses

Review your meals against your Alma Score

Use it when

Tools it uses

Get all 3 without copying a file

How Alma skills work

How to install Alma skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Alma skills FAQ

Put Alma’s best workflows in your agent

Skills for related tools