Skip to content
TakoAPI
Back to skills

totp

by diegofcornejo

CLI Utilities
272Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

TOTP-based OTP verification for sensitive operations (env vars, gateway restarts, backup deletions, critical config.

Description

What This Skill Does

Adds TOTP-based two-factor verification before an agent executes sensitive operations. Uses otplib with a 2-window tolerance (±1 minute) to handle clock drift. Requires a one-time setup with any TOTP authenticator app.

Enforces a hardware-independent second factor at the agent level without modifying the underlying service or infrastructure.

When to Use It

  • Gating access to .env file contents
  • Requiring OTP before restarting a gateway service
  • Confirming identity before deleting backups
  • Protecting critical config file reads
  • Blocking external API key operations without verification

Example Workflow

INPUT

User asks: delete the staging backup

AGENT
  1. 1

    Agent prompts user for a 6-digit OTP from their authenticator app

  2. 2

    User provides the code

  3. 3

    Agent runs: TOTP_SECRET=$TOTP_SECRET node scripts/verify.js 123456

  4. 4

    Script exits 0 if valid, 1 if invalid or expired

  5. 5

    Agent proceeds with deletion on exit 0, denies on exit 1

OUTPUT

Backup deleted after successful OTP verification, or access denied with no action taken

Requirements

  • TOTP_SECRET environment variable (Base32 secret generated during setup)
  • Google Authenticator, Authy, or any TOTP-compatible authenticator app

Installation

clawhub install diegofcornejo/totp

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links