Docs Connect

The KIFF skill for coding agents

A SKILL.md that teaches Claude Code, Codex and similar agents to work with KIFF. Beta: install steps may change. For people who build or connect agents with a coding agent. Install it, then ask your agent to connect a tool or draft a Card.

With it, an agent can connect a tool or agent to KIFF, draft a Card for the owner to issue, and handle a held call without routing around it. It is plain markdown at kiff.dev/skills/kiff.md. Read it before you install it.

The skill is not the security boundary. The MCP gateway enforces each Card on KIFF’s servers. The skill alone enforces nothing.

Install it

Claude Code, as a plugin with this skill, the domain skill and the gateway as a server named kiff:

/plugin marketplace add kiff/kiff-plugins
/plugin install kiff-cards@kiff

Claude Code asks for the agent’s gateway key (from its Tools tab, Claude Code or Codex) and keeps it in its secure storage.

Optional: Card status, notices and recovery in Claude Code

The kiff plugin adds a status line with what is left on the Card, a notice when a call is held, a notice when the owner answers, and the /kiff pane. Install it after kiff-cards:

/plugin install kiff@kiff

It reads kiff_card and kiff_pending, which send nothing and draw nothing. It never approves a call. If Claude Code refuses those reads, type /kiff and allow the tool, or add these rules in /permissions → Allow:

Gateway connection Card read Pending-call read
kiff-cards plugin mcp__plugin_kiff-cards_kiff__kiff_card mcp__plugin_kiff-cards_kiff__kiff_pending
Connect link added as kiff mcp__kiff__kiff_card mcp__kiff__kiff_pending
claude.ai KIFF connector mcp__claude_ai_KIFF__kiff_card mcp__claude_ai_KIFF__kiff_pending

Install only the skill in another agent

Codex:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/kiff" && curl -fsSL https://kiff.dev/skills/kiff.md \
  -o "${CODEX_HOME:-$HOME/.codex}/skills/kiff/SKILL.md"

For Claude Code, use ~/.claude/skills/kiff/SKILL.md instead. Any other agent: save the file as KIFF.md and add “Read KIFF.md before working with KIFF.” to its instructions file.

What to ask

Connect my refund tool to KIFF and give this agent a Card.
KIFF held my last call. What do I do?

What it will not do

  • Issue or change a Card. It drafts the terms; the owner issues them.
  • Answer a held call. Only a signed-in person who may approve can.
  • Ask for an owner or admin credential.
  • Make a held or refused change another way, through a direct API call, a shell or a browser. It reports what happened and stops.