How to use the Awaken skill

Install the Awaken skill in Claude, Codex, Hermes, or OpenClaw for guided tax workflows without configuring MCP.

Before you begin

API access is currently in beta and requires a Dolphin or Whale plan. If the API Keys page says access is not enabled for your client, email beta@awaken.tax to request it.

For a visual walkthrough, watch Installing the Awaken skill for Claude or Codex.

The skill and MCP are separate options

The skill teaches Claude, Codex, Hermes, or OpenClaw how to work with Awaken's API directly. You do not need to configure the MCP server to use it.

Create an API key

Keep the key private

Do not commit the key or paste it into ordinary chat messages. If it is exposed, expired, or no longer needed, revoke it from Settings → API Keys and create a replacement.

1. Open API Keys

In the Awaken workspace you want to use, open Settings → API Keys and select Create API Key.

2. Choose access

Give the key a recognizable name, choose Read for analysis or Read + Write only when you want the skill to edit data, and optionally set an expiration.

3. Copy the secret

Copy the awaken_… secret when it appears; for security, it cannot be viewed again. The key can access only the client where you created it.

Install in Claude Code or Codex

Paste the instruction below into Claude Code or Codex. For a sandboxed Claude environment, download the ZIP distribution instead and add the extracted skill files there.

Claude Code or Codex
install this skill https://api.awaken.tax/skill

Install in Hermes Agent

Awaken is a multi-file skill, so install the complete ZIP bundle into Hermes' skill directory. Start a new Hermes session afterward, or run /reset in an existing session.

Hermes Agent
curl -fsSL https://api.awaken.tax/skill.zip -o /tmp/awaken-skill.zip
mkdir -p ~/.hermes/skills
unzip -o /tmp/awaken-skill.zip -d ~/.hermes/skills

Install in OpenClaw

Install the complete ZIP bundle into OpenClaw's global skill directory. OpenClaw watches its skill roots by default; start a new session after installation so the skill snapshot is refreshed.

OpenClaw
curl -fsSL https://api.awaken.tax/skill.zip -o /tmp/awaken-skill.zip
mkdir -p ~/.openclaw/skills
unzip -o /tmp/awaken-skill.zip -d ~/.openclaw/skills

Download the skill files

Download the packaged skill from api.awaken.tax/skill.zip. The uncompressed skill is also available at api.awaken.tax/skill.

Connect your account once

After installation, run the setup command and paste the API key you created for this client. The skill verifies the key, discovers its client, and saves the connection for later sessions.

text
/awaken setup

Use the skill

After setup, ask naturally about your transactions, portfolio, cost basis, or reports. Claude, Codex, Hermes, or OpenClaw can select the skill when the request matches, or you can invoke Awaken directly.