About

Imported from block/agent-skills (api-setup/SKILL.md). Install upstream with npx skills add block/agent-skills --skill api-setup. Copyright stays with the author.

API Setup

Name: api-setup
Author: block

This skill helps you set up a new API integration with our standard configuration.

Steps

Run setup.sh <api-name> to create the integration directory
Copy templates/config.template.json to your integration directory
Update the config with your API credentials
Test the connection

Configuration

The config template includes:

api_key: Your API key (get from the provider's dashboard)
endpoint: API endpoint URL
timeout: Request timeout in seconds (default: 30)

Verification

After setup, verify:

Config file is valid JSON
API key is set and not a placeholder
Test connection succeeds

Troubleshooting

Connection Timeout

If you experience connection timeouts:

Check your network connection
Verify the endpoint URL is correct
Increase the timeout value in config

Authentication Errors

If you get 401/403 errors:

Verify your API key is correct
Check if the key has the required permissions
Ensure the key hasn't expired

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/block-agent-skills-api-setup/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

block-agent-skills-api-setup.ocm.jsonjson

{
  "ocm": "1",
  "id": "block-agent-skills-api-setup",
  "kind": "skill",
  "name": "api-setup",
  "description": "Set up API integration with configuration and helper scripts",
  "publisher": "block",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "api",
      "integration",
      "setup",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Set up API integration with configuration and helper scripts"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/block/agent-skills",
      "path": "api-setup/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/block/agent-skills/blob/HEAD/api-setup/SKILL.md",
      "key": "block/agent-skills/api-setup/SKILL.md"
    }
  },
  "instructions": "# API Setup\n\nThis skill helps you set up a new API integration with our standard configuration.\n\n## Steps\n\n1. Run `setup.sh <api-name>` to create the integration directory\n2. Copy `templates/config.template.json` to your integration directory\n3. Update the config with your API credentials\n4. Test the connection\n\n## Configuration\n\nThe config template includes:\n\n- `api_key`: Your API key (get from the provider's dashboard)\n- `endpoint`: API endpoint URL\n- `timeout`: Request timeout in seconds (default: 30)\n\n## Verification\n\nAfter setup, verify:\n\n- [ ] Config file is valid JSON\n- [ ] API key is s",
  "cost": {
    "context_tokens": 255
  }
}

Fetch it by URL: GET /api/v1/registry/block-agent-skills-api-setup/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.