# Alma agent skills for Claude Code, Cursor and RevampKey

> Ready-made Alma playbooks for AI agents: check your Alma goal progress, review your meals against your Alma Score. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use Alma nutrition data with AI](https://revampkey.com/marketplace/alma/skills/essentials.md): 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.
- [Check your Alma goal progress](https://revampkey.com/marketplace/alma/skills/goal-progress-check.md): 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.
- [Review your meals against your Alma Score](https://revampkey.com/marketplace/alma/skills/meal-and-score-review.md): 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.

## Install

- RevampKey: connect Alma at https://revampkey.com/marketplace/alma; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
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
```

### 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.

MCP setup guide: https://revampkey.com/marketplace/alma.md