Temps

AI Skills

Give your AI coding agent deep knowledge about Temps. Skills are structured guides that teach AI assistants how to deploy, configure, and integrate with the platform -- no copy-pasting docs required.

Overview

Temps ships with 8 skills that work with AI coding tools like Claude Code, Cursor, Windsurf, Cline, and any agent that supports the skills protocol. Each skill is a curated set of instructions, code examples, and reference material that the AI loads when it recognizes a relevant task.

For example, if you tell your AI agent "deploy my app to Temps", and the deploy-to-temps skill is installed, the agent already knows the exact CLI commands, framework detection logic, Dockerfile patterns, and troubleshooting steps -- without you having to explain anything.

What Skills Provide - Step-by-step workflows for common tasks - Framework-specific code examples - CLI command reference with flags and options - Troubleshooting guides for common errors - Configuration templates and best practices

Supported AI Tools - Claude Code - Cursor - Windsurf - Cline (VS Code) - OpenCode - Any agent supporting the skills protocol

Installation

Skills are installed using the npx skills CLI. You can install all Temps skills at once, or pick individual ones.

Install All Skills

To install every available Temps skill:

npx skills add gotempsh/temps

This launches an interactive selector where you can toggle which skills to install:

Select skills to install (space to toggle)
  ◻ add-custom-domain
  ◻ add-node-sdk
  ◻ add-react-analytics
  ◻ add-session-recording
  ◻ deploy-to-temps
  ◻ temps-cli
  ◻ temps-mcp-setup
  ◻ temps-platform-setup

Press space to toggle individual skills, then enter to install your selection.

Install a Specific Skill

To install a single skill directly (skipping the interactive selector):

npx skills add gotempsh/temps --skill deploy-to-temps

Replace deploy-to-temps with any skill name from the list below.

Skills are installed into your project and become available to your AI agent automatically. No additional configuration is needed after installation.

Available Skills

SkillDescriptionTriggers on
deploy-to-tempsDeploy applications with auto-detection and CI/CD"deploy to temps", "temps deployment"
temps-cliComplete reference for all 54+ CLI commands"temps cli", "temps command"
temps-platform-setupInstall and configure Temps on a server"install temps", "setup temps"
temps-mcp-setupConfigure the MCP server for AI agents"temps mcp", "add temps to claude"
add-react-analyticsAdd analytics, events, and Web Vitals to React apps"add analytics", "track events"
add-session-recordingAdd privacy-aware session recording with rrweb"session recording", "session replay"
add-node-sdkIntegrate KV storage, blob storage, and server-side analytics"temps node sdk", "temps kv"
add-custom-domainConfigure domains with automatic SSL/TLS"custom domain", "ssl certificate"

deploy-to-temps

Deploy applications to Temps with automatic framework detection, Dockerfile generation, and container orchestration.

npx skills add gotempsh/temps --skill deploy-to-temps
  • Name
    Framework Detection
    Description

    Auto-detects Next.js, Vite, Astro, Nuxt, Remix, NestJS, Express, Python, Go, Rust, Java, and generates optimized multi-stage Dockerfiles.

  • Name
    CLI & Git Deployments
    Description

    Deploy from the terminal with bunx @temps-sdk/cli deploy, or configure auto-deploy on git push with preview deployments per PR.

  • Name
    Configuration
    Description

    Covers temps.json build config, environment variables, health checks, resource limits, replicas, and rollback commands.

  • Name
    Troubleshooting
    Description

    Build failures, container startup issues, stuck deployments.

temps-cli

Complete command-line reference covering all 54+ CLI commands. This is the most comprehensive skill (2,000+ lines of documentation).

npx skills add gotempsh/temps --skill temps-cli
  • Name
    Projects & Deployments
    Description

    Create, deploy, rollback, cancel, pause/resume deployments. View logs and status.

  • Name
    Services & Infrastructure
    Description

    Provision PostgreSQL, Redis, MongoDB, and S3. Link services to projects with auto-injected connection strings.

  • Name
    Domains & TLS
    Description

    Custom domains, wildcard certificates, DNS providers (Cloudflare, Route53, DigitalOcean), ACME challenges.

  • Name
    Monitoring & Security
    Description

    Uptime monitors, incidents, vulnerability scanning, error tracking, audit logs, proxy logs.

  • Name
    Email & Notifications
    Description

    Email providers (SES, Scaleway), DKIM domain verification, Slack/email/webhook notification providers.

  • Name
    CI/CD Automation
    Description

    Non-interactive mode (-y flag), JSON output for scripting, environment variable auth, common automation patterns.

temps-platform-setup

Install, configure, and manage a self-hosted Temps instance from scratch.

npx skills add gotempsh/temps --skill temps-platform-setup
  • Name
    Installation Methods
    Description

    Install script (curl -fsSL https://temps.sh/deploy.sh | sh), Docker Compose (production), or build from source (Rust 1.70+).

  • Name
    Initial Setup
    Description

    Database migrations, TimescaleDB extension, admin user creation, DNS provider config, Let's Encrypt ACME account, encryption keys.

  • Name
    Platform Administration
    Description

    User management (Admin/User/Viewer roles), API keys, service provisioning, backups, monitoring, and logs.

  • Name
    DNS & TLS
    Description

    Cloudflare, AWS Route53, and DigitalOcean integration. Custom and wildcard domains, automatic certificate provisioning.

  • Name
    Troubleshooting
    Description

    Database connection, port conflicts, TLS issues, deployment failures, GeoLite2 setup for IP geolocation.

temps-mcp-setup

Configure the Temps MCP server so AI assistants can manage your infrastructure through natural language.

npx skills add gotempsh/temps --skill temps-mcp-setup
  • Name
    Client Configuration
    Description

    Step-by-step setup for Claude Desktop (macOS/Windows) and Claude Code (VS Code).

  • Name
    Available Tools
    Description

    list_projects, get_project, list_deployments -- query your Temps platform directly from an AI chat.

  • Name
    Prompts
    Description

    Includes the add_react_analytics prompt for guided analytics setup across frameworks.

  • Name
    Verification & Troubleshooting
    Description

    How to verify the connection works, fix tools not appearing, resolve permission errors.

For a more comprehensive MCP reference covering all 158 tools and setup for 7+ AI clients, see the MCP Server documentation.

add-react-analytics

Add Temps analytics to React applications with tracking for page views, custom events, scroll depth, engagement, session recording, and Web Vitals.

npx skills add gotempsh/temps --skill add-react-analytics
  • Name
    Framework Support
    Description

    Next.js App Router, Next.js Pages Router, Vite, Create React App, and Remix -- with framework-specific provider setup.

  • Name
    7 React Hooks
    Description

    useTrackEvent, useAnalytics, useScrollVisibility, usePageLeave, useEngagementTracking, useSpeedAnalytics, useTrackPageview.

  • Name
    Session Recording
    Description

    rrweb-based recording with privacy controls (masking, blocking, GDPR consent flow).

  • Name
    Bundled References
    Description

    Includes detailed hook API reference and session recording guide as additional reference files.

add-session-recording

Add privacy-aware session recording and replay using rrweb. Focused specifically on the recording feature with detailed privacy controls.

npx skills add gotempsh/temps --skill add-session-recording
  • Name
    Quick Setup
    Description

    Wrap your app with TempsAnalyticsProvider + SessionRecordingProvider and recording starts automatically.

  • Name
    Privacy Controls
    Description

    Block elements by CSS class (sensitive), mask text with data-rr-mask, block entire elements with data-rr-block. Patterns for payment forms, personal data, medical records.

  • Name
    Programmatic Control
    Description

    useSessionRecordingControl hook to start, stop, and toggle recording at runtime.

  • Name
    GDPR Compliance
    Description

    Full consent flow implementation with localStorage persistence and conditional recording by environment, user plan, or page.

add-node-sdk

Integrate the Temps Node.js SDK for server-side analytics, KV storage, blob storage, and platform API access.

npx skills add gotempsh/temps --skill add-node-sdk
  • Name
    Server-Side Tracking
    Description

    temps.track() and temps.identify() for backend event tracking, plus Express middleware for auto-tracking API requests.

  • Name
    KV Storage
    Description

    Redis-like key-value store with JSON serialization, TTL support, metadata, and prefix-based listing via @temps-sdk/kv.

  • Name
    Blob Storage
    Description

    File upload/download, stream support, signed URLs, and presigned upload URLs via @temps-sdk/blob.

  • Name
    Error Handling
    Description

    Typed errors (TempsError, RateLimitError, NotFoundError) with retry logic and full TypeScript generics support.

add-custom-domain

Configure custom domains for Temps deployments with automatic SSL/TLS via Let's Encrypt.

npx skills add gotempsh/temps --skill add-custom-domain
  • Name
    DNS Configuration
    Description

    CNAME records for subdomains, A records for apex domains, wildcard support. Includes exact DNS record values.

  • Name
    TLS Challenges
    Description

    HTTP-01 (standard, automatic) and DNS-01 (for wildcards, requires Cloudflare integration).

  • Name
    Certificate Management
    Description

    Automatic renewal 30 days before expiration, status monitoring, force renewal. Multiple domains per project.

  • Name
    Cloudflare Integration
    Description

    API token setup (Zone:DNS:Edit permission), Zone ID configuration, wildcard domain provisioning.

Additional Resources

MCP Server Setup

Temps SDKs

CLI Getting Started

Was this page helpful?