Agent skill

Soundcloud API Integration

by soundcloud in soundcloud/api

Integrates applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs.

No licenceAuto-check passedBackend & APIs

Install Soundcloud API Integration

skills CLI
$ npx skills add soundcloud/api --skill soundcloud-api-integration -a claude-code

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

GitHub CLI
$ gh skill install soundcloud/api soundcloud-api-integration --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/soundcloud/api.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/soundcloud-api-integration .claude/skills/soundcloud-api-integration && 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
soundcloud-api-integration
GitHub stars
258
Token cost
~787 tokens
SKILL.md length
230 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
None found

At a glance

Integrates applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs.

  • Works in 10 steps: API base: https://api.soundcloud.com —… → Auth: OAuth 2.1. Authorization Code flow… → API requests: Authorization: OAuth… → …
  • Building SoundCloud API clients
  • SKILL.md covers Authoritative sources, Core rules, Auth flow selection and Request template, plus 3 more sections
  • Calls curl; reaches api.soundcloud.com and secure.soundcloud.com; needs ACCESS_TOKEN and BASE64_CLIENT_ID_SECRET

What it does

Soundcloud API Integration is an agent skill from soundcloud/api. Integrates applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs. Use when building SoundCloud API clients, auth flows, uploads, playback, pagination, or debugging API errors.

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering OAuth and OpenID Connect, Third-party API integration and Authentication. It works with OpenAPI. The repository describes itself as: A public repo for our Developer Community to engage about bugs and feature requests on our Public API.

When your agent uses it

  • Building SoundCloud API clients
  • Debugging API errors

Example prompts

  • “Use the soundcloud-api-integration skill to integrate applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs”
  • “/soundcloud-api-integration”

Requirements

  • A credential in ACCESS_TOKEN
  • A credential in BASE64_CLIENT_ID_SECRET

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. API base: https://api.soundcloud.com — token host: https://secure.soundcloud.com
  2. Auth: OAuth 2.1. Authorization Code flow requires PKCE. Do not use legacy api.soundcloud.com/oauth2/token.
  3. API requests: Authorization: OAuth unless the OpenAPI operation specifies otherwise.
  4. Resource identifiers: Use URNs in path parameters (e.g. soundcloud:users:948745750, soundcloud:tracks:308946187). Numeric ids are…
  5. Tokens: Access tokens expire ~1 hour. Refresh tokens are single-use. Cache tokens; renew with refresh_token grant instead of repeated…
  6. Client Credentials limits: 50 tokens / 12h per app, 30 / 1h per IP — cache and refresh.
  7. Pagination: Prefer linked_partitioning=true and follow next_href until absent.
  8. Playback: Use /tracks/{track_urn}/streams (not legacy /stream). Check access: playable, preview, blocked.
  9. Rate limits: Back off on 429 (including play-stream quota: 15k / 24h per client_id).
  10. Secrets: Never hardcode client_id, client_secret, or tokens — use env vars or a secrets manager.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    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.soundcloud.com
    • secure.soundcloud.com

    Also links to:

    • developers.soundcloud.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ACCESS_TOKEN
    • BASE64_CLIENT_ID_SECRET

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

Context cost

Soundcloud API Integration loads about 787 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 230 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~787

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 230 words (~787 tokens).

“Use these; do not invent endpoints or headers:”

— opening of SKILL.md by soundcloud
name
soundcloud-api-integration

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .cursor/skills/soundcloud-api-integration of soundcloud/api.

Open the folder on GitHubat commit 33092b8

Compare with similar skills

Soundcloud API Integration 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.

Soundcloud API Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Soundcloud API Integration this skillsoundcloud/api258—~787Automated safety check: PassNone
Discord Openapi Skillholon-run/uxc116—~2.2kAutomated safety check: PassMIT
OpenAPI CLI CallerEvilFreelancer/openapi-to-cli265—~879Automated safety check: PassMIT
Frappe Core APIImpertio-Studio/Frappe_Claude_Skill_Package1871 repos~3.2kAutomated safety check: PassMIT
FastAPI ExpertJeffallan/claude-skills12k—~1.8kAutomated safety check: PassMIT
NestJS ExpertJeffallan/claude-skills12k—~2kAutomated safety check: PassMIT

Similar skills

  • Operate Discord HTTP API through UXC with Discord OpenAPI schema.

    116 GitHub stars~2.2k tokensUpdated 23 days ago
    Backend & APIsAuto-check passed
  • OpenAPI CLI Caller

    EvilFreelancer/openapi-to-cli

    Turns an OpenAPI, Swagger or OpenRPC spec into CLI commands the agent can search and call, with no MCP server or code generation.

    265 GitHub stars~879 tokensUpdated 16 days ago
    Backend & APIsAuto-check passed
  • Frappe Core API

    Impertio-Studio/Frappe_Claude_Skill_Package

    A skill your agent uses when building ERPNext/Frappe API integrations (v14/v15/v16) including REST API, RPC API, authentication, webhooks, and rate limiting.

    187 GitHub starsUsed in 1 repo~3.2k tokens
    Backend & APIsAuto-check passed
  • FastAPI Expert

    Jeffallan/claude-skills

    Builds async Python APIs with FastAPI and Pydantic V2, covering endpoints, JWT authentication, async SQLAlchemy, WebSockets and pytest checks against the OpenAPI docs.

    12k GitHub stars~1.8k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • NestJS Expert

    Jeffallan/claude-skills

    Scaffolds NestJS modules, controllers, services, DTOs and guards for TypeScript backends, with validation, JWT and Passport auth, Swagger docs and unit and E2E tests.

    12k GitHub stars~2k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Mock REST APIs

    mendixlabs/mxcli

    Stand up an HTTP endpoint you control instead of a live third-party API, and point the Mendix app at it — Prism from an OpenAPI contract, a constant swap, or a forward proxy.

    128 GitHub starsUsed in 1 repo~2.5k tokens
    Backend & APIsAuto-check passed

More from soundcloud/api

  • Soundcloud API Auth

    soundcloud/api

    Implements SoundCloud OAuth 2.1 flows — Authorization Code with PKCE and Client Credentials — including token refresh and secure credential storage.

    258 GitHub stars~562 tokensUpdated 8 days ago
    Auto-check passed
  • Implements SoundCloud discovery endpoints — track search, related tracks, and related artists — with URN path parameters and linkedpartitioning pagination.

    258 GitHub stars~449 tokensUpdated 8 days ago
    Auto-check passed

Works with

Categories

Questions about Soundcloud API Integration

What does Soundcloud API Integration do?

Integrates applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs. Soundcloud API Integration is an agent skill from soundcloud/api.1, OpenAPI, and developer docs.

When should I use Soundcloud API Integration?

Soundcloud API Integration fits situations like: building SoundCloud API clients; debugging API errors.

How do I install Soundcloud API Integration in Claude Code?

Run `npx skills add soundcloud/api --skill soundcloud-api-integration -a claude-code`. Or copy the skill folder (.cursor/skills/soundcloud-api-integration in soundcloud/api) into .claude/skills/soundcloud-api-integration in your project. Claude Code loads it when a task matches its description.

How do I install Soundcloud API Integration in Codex?

Run `npx skills add soundcloud/api --skill soundcloud-api-integration -a codex`. Or copy the skill folder (.cursor/skills/soundcloud-api-integration in soundcloud/api) into .agents/skills/soundcloud-api-integration in your project. Codex loads it when a task matches its description.

Can I use Soundcloud API Integration 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 soundcloud/api --skill soundcloud-api-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/soundcloud-api-integration, .gemini/skills/soundcloud-api-integration, .github/skills/soundcloud-api-integration and .opencode/skills/soundcloud-api-integration in your project.

What does Soundcloud API Integration need to run?

Going by SKILL.md and its folder, Soundcloud API Integration needs the command-line tools its instructions call (curl) and credentials named ACCESS_TOKEN and BASE64_CLIENT_ID_SECRET. Our summary lists: A credential in ACCESS_TOKEN; A credential in BASE64_CLIENT_ID_SECRET.

Does Soundcloud API Integration access the network?

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

Is Soundcloud API Integration 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 Soundcloud API Integration use?

No licence was found for Soundcloud API Integration or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Soundcloud API Integration use?

About 787 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Soundcloud API Integration?

Skills that share tags, products or a category with Soundcloud API Integration: Discord Openapi Skill (holon-run/uxc, 116 stars), OpenAPI CLI Caller (EvilFreelancer/openapi-to-cli, 265 stars), Frappe Core API (Impertio-Studio/Frappe_Claude_Skill_Package, 187 stars) and FastAPI Expert (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Soundcloud API Integration?

soundcloud (a GitHub organization) maintains it in soundcloud/api, which has 258 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 30, 2026.

Source: soundcloud/api on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.