AgentSkillsCN

api-openapi-generic

如何安全集成外部 API;如何在不污染上下文的前提下存储并查询 OpenAPI。

SKILL.md
--- frontmatter
name: api-openapi-generic
description: How to integrate external APIs safely; how to store and query OpenAPI without polluting context.

API Integration (Generic)

  • Prefer finding OpenAPI/Swagger spec; store it in references/ (not pasted into chat).
  • Implement:
    • timeouts
    • retries with backoff
    • idempotency where required
    • clear error classification (retryable vs non-retryable)
  • Keep a project overlay skill api-<vendor> with endpoints used by the project.