Skills for AI agents

The Kombine skill teaches an AI agent how to use your Kombine account: which requests to make, what the fields mean and what to do when something fails. Once it’s installed you just ask:

• “What’s due today?”
• “Add a task to call the bank tomorrow, high priority.”
• “Mark the passport task done.”
• “Log 45 minutes of deep work on the migration.”
• “How many focus sessions did I do this week? How’s my streak?”
• “Is a timer running on my phone?”

It works in Claude Code, Codex, Cursor, GitHub Copilot and other agents that support Agent Skills. The skill is free and open source: github.com/asvid/kombine-skills.

Before changing anything, the agent shows you what it’s about to create, change or delete and waits for your OK.

1. Create a token

The agent uses a personal access token. Create one at app.kombine.dev under Settings › Account › Personal access tokens, and give it only what you want the agent to do:

You want the agent to…	Permissions
Answer questions about your tasks and stats	tasks, sessions, stats, timer: Read
Also add, edit and complete tasks	tasks: Read & write
Also log focus sessions	sessions: Read & write
Also work with your goals	goals: Read or Read & write

2. Give the token to your agent

Put the token in an environment variable called KOMBINE_TOKEN. Add this line to your shell profile (~/.zshrc on a Mac, ~/.bashrc on most Linux systems):

export KOMBINE_TOKEN='kmb_pat_…'

Then open a new terminal and restart your agent so it picks up the variable.

Don’t paste the token into a chat with the agent. Chats are saved, and the token would end up in them.

3. Install the skill

Claude Code

In Claude Code, run these two commands:

/plugin marketplace add asvid/kombine-skills
/plugin install kombine@kombine

Restart Claude Code. To get updates later, run /plugin marketplace update kombine.

Other agents

With Node.js installed, run this in a terminal:

npx skills add asvid/kombine-skills

It asks which agents to install the skill for. To update later, run npx skills update.

By hand

The skill is one text file. Download SKILL.md and save it in a folder called kombine inside your agent’s skills folder:

Agent	Save it as
Claude Code	~/.claude/skills/kombine/SKILL.md
Other agents	kombine/SKILL.md in the skills folder named in your agent’s docs

Or in a terminal:

mkdir -p ~/.claude/skills/kombine
curl -o ~/.claude/skills/kombine/SKILL.md \
  https://raw.githubusercontent.com/asvid/kombine-skills/main/skills/kombine/SKILL.md

To update, download it again.

The skill needs nothing else installed: it only uses curl, which macOS and Linux include.

4. Try it

Ask your agent “what’s due today in Kombine?”. If it says the token is missing, check that echo $KOMBINE_TOKEN prints something in a new terminal, then restart the agent.

The agent reports	What to do
Token expired or revoked (401)	Create a new token and update KOMBINE_TOKEN
Token doesn’t allow this (403)	Create a token with the permission it needs (see step 1)
Too many requests (429)	Wait a minute. A token allows 60 requests a minute

Remove it

Delete the token under Settings › Account › Personal access tokens. That stops the agent at once, wherever the skill is installed. Then remove the skill: /plugin uninstall kombine@kombine in Claude Code, npx skills remove kombine, or delete the kombine folder you created.

For your own scripts and importers, see Workflows.