Api integration

Skill choutos/agent-skills-spec/examples/api-integration

Open specification for packaging procedural knowledge for AI agents. Framework-agnostic SKILL.md format.

Install

npx -y skills add choutos/agent-skills-spec --skill api-integration

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Integrate with the Acme API for file management operations. Use when uploading, downloading, listing, or managing files via the Acme platform. Triggers on: acme, file upload, file management, acme API.

SKILL.md

1.1 KB, as published. Nobody here has run it

Acme API Integration

Auth: Bearer token from ACME_TOKEN env var. Base URL: https://api.acme.example.com/v2 Rate limit: 60 requests/minute

Common Operations

Action	Method	Endpoint
List files	GET	`/files?directory_id={id}`
Upload	POST	`/upload?directory_id={id}` (multipart)
Download	GET	`/files/{id}/download`
Create dir	POST	`/files/{parent_id}/directory`
Delete	DELETE	`/files/{id}`

Auth Pattern

source ~/.credentials/acme.env
curl -s -H "Authorization: Bearer $ACME_TOKEN" "$ACME_BASE/files?directory_id=1"

Upload

curl -s -X POST "$ACME_BASE/upload?directory_id=$DIR_ID" \
  -H "Authorization: Bearer $ACME_TOKEN" \
  -F "file=@/path/to/file"

Notes

All responses wrapped in {"result": "success", "data": ...}
Parse with jq .data
For full schema, see references/api-schema.md