skills.rest
paarths-collab
paarths-collabCOMMUNITY
Explore all skills by this author →
GitHub

integration-segment

Connect Segment to a self-hosted Hermes agent via SSH.

13|1|Updated Jun 1, 2026
Search Tags:#rollback#cdp#ssh#segment#public-api#hermes#tracking-api
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill integration-segment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: integration-segment
Source: https://github.com/paarths-collab/hstack/tree/main/skills/integration-segment
Command: npx skills add https://github.com/paarths-collab/hstack --skill integration-segment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual work of wiring Segment into a self-hosted Hermes agent, so an AI operator can set up event tracking and destination fan-out safely and repeatably.

Core Features & Use Cases

  • SSH-first integration: Configures Segment from the VPS side where Hermes runs, keeping the workflow remote, idempotent, and rollback-safe.
  • Tracking and public API support: Handles the Segment Tracking API for event writes and the optional Public API for workspace and delivery checks.
  • Validation and safety gates: Verifies Hermes reachability, write key format, region selection, environment loading, and smoke tests before finishing.
  • Use case: A team wants their agent to emit analytics events to Segment and confirm they appear in Source Debugger without exposing secrets to the local machine.

Quick Start

Use this skill to connect my Segment source to a remote Hermes VPS, verify the write key and region, and complete the integration end to end.

Frequently Asked Questions about integration-segment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Segment CDP to a self-hosted Hermes agent over SSH?▼

To connect Segment CDP to a self-hosted Hermes agent, this Skill automates SSH-first deployment by configuring the VPS side, applying write keys, reloading the gateway, and verifying event delivery. It manages the entire integration without manual wiring.

What do I need to validate before writing Segment tracking events to a remote VPS?▼

Validating Segment tracking events requires verifying Hermes reachability, checking the write key format, confirming region selection, and running smoke tests. This ensures the environment loads correctly and credentials are region-aware before completing the setup.

Can I use the Segment Public API to manage workspace sources from my VPS?▼

Yes, you can use the Segment Public API alongside the Tracking API. This Skill supports optional Public API tokens to perform workspace delivery checks and manage sources directly during the SSH-first integration workflow.

Does the Hermes SSH integration support rollback for environment updates?▼

Yes, the Hermes SSH integration supports rollback-safe environment updates. If the validation gates fail when verifying reachability or credential formats, the workflow ensures the VPS configuration can safely revert to its previous state.

Why are my Segment analytics events not appearing in the Source Debugger?▼

Segment analytics events may fail to appear in the Source Debugger if the region selection or write key format is incorrect. This Skill validates these credentials and runs smoke tests to confirm events successfully reach the Hermes agent.

Related Skills

Explore More Software Engineering Skills→
paarths-collabpaarths-collab
13

platform-mattermost

Configure a remote Hermes Agent for Mattermost with bot access and allowlists.

Community
Advanced
triodelabtriodelab

inngest-events

Design Inngest event schemas with idempotency IDs and fan-out patterns.

Community
Advanced
Avi977Avi977

vps-deploy

Automate GitHub-to-VPS deployment with SSH keys, workflows, and health checks.

Community
Advanced
paarths-collabpaarths-collab
13

integration-obsidian

Connect an Obsidian vault to a self-hosted Hermes agent via SSH.

Community
Advanced