TokST Durable context for people and AI agents

Skill Guide

The TokST skill file (skill.md) is a self-contained document that AI agents can read to use TokST Cloud MCP memory. This page documents how to use it.

What is skill.md?

skill.md is a single Markdown file hosted at https://tokst.com/skill.md. It contains the operational rules an AI agent needs to:

  1. Complete browser authorization or use an API key for automation
  2. Place the Skill in its client directory when that client supports Skills
  3. Read, search, store, and govern durable memories

Agents can read it via URL fetch or users can paste its content directly into a chat.

One-Link Setup

Share this link with any AI agent so it can read the current setup and operating rules:

https://tokst.com/skill.md

How to use it

Copy this message and paste it into your agent's chat:

Read https://tokst.com/skill.md. Connect to TokST Cloud MCP, complete authorization, retrieve relevant context before substantial work, and save only confirmed long-term information as Markdown with a clear heading and concise sections.

The MCP client opens browser authorization. The same skill.md works with WorkBuddy, ZCode, Qoder, Kimi, and other clients that support Skills or MCP. This Skill covers the complete memory surface and operates entirely through Cloud MCP.

Version Checking

The skill file includes a version marker (<!-- skill-version: 0.9.0 -->). Agents can compare their locally installed version against the remote to detect updates:

# Installed version
grep "^version:" ~/.claude/skills/tokst-memory/SKILL.md

# Latest version
curl -fsSL https://tokst.com/skill.md | grep "skill-version:"

Supported Agents

Place skill.md as SKILL.md in the directory used by the target client:

AgentSkill directory
Claude Code~/.claude/skills/tokst-memory/
ZCode~/.zcode/skills/tokst-memory/
Cursor / Windsurf~/.cursor/skills/tokst-memory/
Codex CLI~/.codex/skills/tokst-memory/
Pi~/.pi/skills/tokst-memory/
WorkBuddy~/.workbuddy/skills/tokst-memory/
Qoder~/.qoder/skills/tokst-memory/
Kimi Code~/.kimi-code/skills/tokst-memory/
Generic MCP~/.agents/skills/tokst-memory/

Connection modes

Browser-capable MCP clients can connect to https://api.tokst.com/mcp and approve OAuth in TokST. Static MCP clients use a dedicated API key in the Authorization header.

TokST Cloud MCP exposes 32 tools for memories, workspaces, files, and account status. The public Skill includes a concise recovery path for PATH conflicts, browser approval, static MCP authorization, quota failures, and durable-memory recovery.

Dashboard Integration

When you create an API key for automation in the dashboard, the creation modal provides:

  • A ready-to-copy SKILL.md with your key embedded
  • A Quick Start script for terminal paste
  • An MCP config JSON
  • A per-key Copy for Agent button

Browser sign-in and remote MCP approval do not create an API key. Use the Agents page to review trusted agt_... identities and connected endpoint status.

WorkBuddy, ZCode, Qoder, and Kimi Code can also import https://tokst.com/skill.md from their Skills or Agent Skills settings.

Related