Pontx HubAPI reference for humans & agents
DOCSPontx Hub
Public docsv1
On this pageAgent Skill

Agent / universal Skill

Let agents retrieve APIs on demand, not memorize the catalog.

Install the universal Pontx Hub Skill so agents search, inspect, preview, and call APIs through the universal CLI after authorization.

01Discoverpontx-hub search
02Inspectpontx-hub show
03Previewpontx-hub preview
04Integratepontx-hub sdk
01

Install the Skill

Install once; API data is always retrieved on demand through the CLI.

Agent Skills
npx skills add https://github.com/pontjs/pontx-hub --skill pontx-hub

The CLI installs to .agents/skills/pontx-hub in the current project. Use --output to choose a location and --force to explicitly update an existing Skill.

02

Agent workflow

The Skill turns an open-ended API request into six reviewable steps.

01searchFind capability
02showInspect resource
03previewPreview request
04confirmConfirm side effect
05callCall when authorized
06sdkGenerate integration
Agent execution trace
pontx-hub search "把欧元换算成美元的接口" --locale zh --json
pontx-hub show endpoint:frankfurter/get-latest-rates
pontx-hub frankfurter preview 'Exchange Rates' getLatestRates --base USD
# The agent calls only after the user asks for execution.
pontx-hub frankfurter call 'Exchange Rates' getLatestRates --base USD
03

Keep context lean

The Skill does not copy the whole OpenAPI catalog; it teaches the agent which resource to load and when.

Long-lived contextSkill workflow
On demandAPI → Endpoint → Schema
Final outputPreview → Call → SDK

This reduces stale docs, wrong parameters, and irrelevant Schemas while keeping every choice traceable to a stable resource ID.

04

Boundaries that cannot be bypassed

The Skill extends retrieval and execution capability, not user authorization.

  • ✓Search, explanation, or code generation does not imply execution permission.
  • ✓Mutations require an exact preview before user confirmation.
  • ✓Credentials come from environment variables, never arguments, logs, or responses.
  • ✓Only catalog-approved APIs, Endpoints, and servers can be called.
→

Open the indexable Skill page, or read the credential and mutation model in depth.

Open the Skill page