Agent skill

Flexport Observability

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Instrument Flexport REST, MCP, OAuth, and webhook outcomes without logging logistics payloads or credentials.

MITAuto-check passedBackend & APIs

Install Flexport Observability

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-observability -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace flexport-observability --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/flexport-observability .claude/skills/flexport-observability && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flexport-observability
GitHub stars
2.8k
Token cost
~1.1k tokens
SKILL.md length
402 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Instrument Flexport REST, MCP, OAuth, and webhook outcomes without logging logistics payloads or credentials.

  • Works in 6 steps: Define safe dimensions → Measure auth health → Measure reads and mutations separately → …
  • Defining metrics
  • SKILL.md covers Overview, Prerequisites, Instructions and Authentication, plus 5 more sections
  • Reaches api.flexport.com and mcp.flexport.com

What it does

Flexport Observability is an agent skill from jeremylongshore/tons-of-skills-marketplace. Instrument Flexport REST, MCP, OAuth, and webhook outcomes without logging logistics payloads or credentials. Use when defining metrics, traces, dashboards, or alerts. Trigger with: "monitor Flexport integration", "Flexport metrics", "trace Flexport webhooks".

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-docs.md`). Compatibility notes: Requires an approved telemetry platform, redaction policy, and business service objectives.

It sits in Backend & APIs, covering Webhooks, Observability and OAuth and OpenID Connect. It works with Model Context Protocol. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Defining metrics
  • With: monitor Flexport integration
  • Flexport metrics
  • Trace Flexport webhooks

Example prompts

  • “monitor Flexport integration”
  • “Flexport metrics”
  • “trace Flexport webhooks”
  • “/flexport-observability”

Requirements

  • Compatibility (from SKILL.md): Requires an approved telemetry platform, redaction policy, and business service objectives.
  • Pre-approved tools (allowed-tools): Read, Grep, Write, Edit

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Define safe dimensions
  2. Measure auth health
  3. Measure reads and mutations separately
  4. Measure webhooks in stages
  5. Alert on objectives
  6. Audit telemetry

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.flexport.com
    • mcp.flexport.com

    Also links to:

    • apidocs.flexport.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires an approved telemetry platform, redaction policy, and business service objectives.

    From compatibility in the SKILL.md frontmatter.

Context cost

Flexport Observability loads about 1.1k tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 402 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 402 words, ~1,057 tokens.

Download SKILL.mdSave it as .claude/skills/flexport-observability/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
flexport-observability
description
Instrument Flexport REST, MCP, OAuth, and webhook outcomes without logging logistics payloads or credentials. Use when defining metrics, traces, dashboards, or alerts. Trigger with: "monitor Flexport integration", "Flexport metrics", "trace Flexport webhooks".
allowed-tools
Read, Grep, Write, Edit
compatibility
Requires an approved telemetry platform, redaction policy, and business service objectives.
version
2.0.0
argument-hint
[surface-and-service-objectives]
model
inherit
effort
high
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, flexport, observability, security

Identifier-Safe Flexport Observability

Overview

Observe operations and reconciliation, not shipment contents. Build low-cardinality telemetry around surface, operation class, outcome, version, and queue health while keeping identifiers and payloads out.

Prerequisites

  • Approved metric labels and redaction rules
  • Operation taxonomy across OAuth, REST, MCP, webhook, and local processing
  • Business-defined service objectives and incident ownership

Instructions

Step 1: Define safe dimensions

Use environment, surface, operation class, status family, error class, version selection, and release. Exclude URLs with IDs, names, emails, routes, tags, documents, tokens, and raw messages.

Step 2: Measure auth health

Track cache hit, refresh success, token-request count, and credential alias as a controlled internal dimension; never log tokens or secret fragments.

Step 3: Measure reads and mutations separately

Record latency, attempts, pages, queue age, reconciliation lag, and ambiguous outcomes by operation class.

Step 4: Measure webhooks in stages

Distinguish received, signature-valid, durably queued, deduplicated, processed, and reconciled counts.

Step 5: Alert on objectives

Derive thresholds from approved freshness, queue, and error objectives—not arbitrary fixed seconds or undocumented rate headers.

Step 6: Audit telemetry

Sample schemas and label cardinality for sensitive leakage and regressions before expanding collection.

Authentication

REST calls authenticate with a cached OAuth 2.0 client-credentials Bearer token using audience https://api.flexport.com, or an explicitly accepted broad API key. Use distinct credentials per workload and never log credentials or tokens. MCP calls use the authenticated connection to https://mcp.flexport.com/mcp and remain subject to each tool's documented account permissions.

Show full SKILL.md (167 more words)Show less

Tool Discipline

Use Read and Grep for discovery and evidence. Use Write or Edit only for the approved artifact, code, configuration, test, or receipt described by this workflow; do not make an unapproved Flexport-side change.

Output

  • Scoped decision or implementation artifact
  • Redacted operation and validation receipt
  • Failure, rollback, and follow-up ownership record

Return a machine-reviewable receipt in this shape; adapt the operation values, but never place credentials or provider payloads in it:

yaml
surface: rest-v3
operation: shipment-read
decision: approved
outcome: verified
evidence:
  release_sha: recorded-out-of-band
  provider_reference: redacted
rollback_owner: logistics-platform

Examples

A dashboard shows surface=mcp, operation=shipment-read, outcome, latency, and reconciliation lag. It never labels a series with FLEX-ID, route, company, email, or tool arguments.

Error Handling

FailureResponse
Identifier appears in labelsDrop or hash only under approved policy, then control cardinality.
Raw provider message contains dataMap to a safe error class and protect restricted details separately.
Alert has no business objectiveDisable it until an owner defines the decision it drives.
Webhook counts divergeBound the window and run authenticated reconciliation.

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/.curated/flexport-observability of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/official-docs.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Flexport Observability next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flexport Observability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flexport Observability this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.1kAutomated safety check: PassMIT
Debug Cloudflare Workers ObservabilityConsensys/c0105—~1.2kAutomated safety check: NotesLGPL-3.0
Stripe Best Practiceskanchengw/cnllm1732 repos~925Automated safety check: PassApache-2.0
X Twitter ScraperXquik-dev/x-twitter-scraper2111 repos~2.6kAutomated safety check: PassMIT
Zalo AgentPhucMPham/zalo-agent-cli166—~2.3kAutomated safety check: PassMIT
Xquik MCPXquik-dev/x-twitter-scraper2111 repos~997Automated safety check: PassMIT

Similar skills

  • Debug deployed Cloudflare Workers using the cfobservability MCP, Wrangler, D1/R2 state, repo evidence, and safe live reproduction.

    105 GitHub stars~1.2k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Stripe Best Practices

    kanchengw/cnllm

    Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…

    173 GitHub starsUsed in 2 repos~925 tokens
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    Xquik-dev/x-twitter-scraper

    Use Xquik to fetch X (Twitter) data or act through a connected account: search, profiles, followers, replies, threads, timelines, media downloads, bulk exports, trends, monitors, signed webhooks…

    211 GitHub starsUsed in 1 repo~2.6k tokens
    Backend & APIsAuto-check passed
  • Zalo Agent

    PhucMPham/zalo-agent-cli

    Automate Zalo messaging, Official Account (OA), and MCP server integration via zalo-agent-cli.

    166 GitHub stars~2.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Xquik MCP

    Xquik-dev/x-twitter-scraper

    Connect, verify, and troubleshoot Xquik's remote MCP server.

    211 GitHub starsUsed in 1 repo~997 tokens
    Backend & APIsAuto-check passed
  • Discord Php Bot Security

    discord-php/DiscordPHP

    Audit checklist for DiscordPHP bots and API libraries — stop the bot token leaking to third-party APIs or logs, keep secrets out of customids and exception messages, use constant-time comparison and…

    1.1k GitHub stars~1.2k tokensUpdated today
    Backend & APIsAuto-check: notes

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Flexport Observability

What does Flexport Observability do?

Instrument Flexport REST, MCP, OAuth, and webhook outcomes without logging logistics payloads or credentials. Flexport Observability is an agent skill from jeremylongshore/tons-of-skills-marketplace. Instrument Flexport REST, MCP, OAuth, and webhook outcomes without logging logistics payloads or credentials.

When should I use Flexport Observability?

Flexport Observability fits situations like: defining metrics; with: monitor Flexport integration; flexport metrics; trace Flexport webhooks.

How do I install Flexport Observability in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-observability -a claude-code`. Or copy the skill folder (skills/.curated/flexport-observability in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/flexport-observability in your project. Claude Code loads it when a task matches its description.

How do I install Flexport Observability in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-observability -a codex`. Or copy the skill folder (skills/.curated/flexport-observability in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/flexport-observability in your project. Codex loads it when a task matches its description.

Can I use Flexport Observability in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-observability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flexport-observability, .gemini/skills/flexport-observability, .github/skills/flexport-observability and .opencode/skills/flexport-observability in your project.

What does Flexport Observability need to run?

SKILL.md names no scripts, command-line tools or credentials: Flexport Observability is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Write, Edit. Compatibility (from SKILL.md): Requires an approved telemetry platform, redaction policy, and business service objectives..

Does Flexport Observability access the network?

SKILL.md names 3 domains. In commands or code: api.flexport.com and mcp.flexport.com; the agent is likely to contact these when it follows the instructions. As links in the text: apidocs.flexport.com. This is read from the text; nothing was executed.

Is Flexport Observability safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flexport Observability use?

Flexport Observability is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flexport Observability use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 215 tokens, read only when the agent opens those files.

What are the alternatives to Flexport Observability?

Skills that share tags, products or a category with Flexport Observability: Debug Cloudflare Workers Observability (Consensys/c0, 105 stars), Stripe Best Practices (kanchengw/cnllm, 173 stars), X Twitter Scraper (Xquik-dev/x-twitter-scraper, 211 stars) and Zalo Agent (PhucMPham/zalo-agent-cli, 166 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flexport Observability?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.