Skip to content
Back to search

portal

MarketplaceWorks with Claude CodeGitHub

Official Spotify Portal plugin marketplace for AI coding tools.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spotify--portal-ai-plugins/badge.svg)](/listings/spotify--portal-ai-plugins)

HTML

<a href="/listings/spotify--portal-ai-plugins"><img src="/api/listings/spotify--portal-ai-plugins/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

claude plugin marketplace add spotify/portal-ai-plugins
claude plugin install portal@portal
claude plugin install shunt@portal   # optional: token-saving AiKA delegation

Start a new session and run:

/portal:setup

Codex

codex plugin marketplace add spotify/portal-ai-plugins
codex

Open `/plugins`, install Spotify Portal, start a new task, and ask:

Set up Spotify Portal for me.

Cursor

Register the [spotify/portal-ai-plugins](https://github.com/spotify/portal-ai-plugins) repository in your Cursor team marketplace, then install Spotify Portal from **Cursor Settings → Plugins**.

pi

pi install git:github.com/spotify/portal-ai-plugins

Start a new session and run:

/skill:setup

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 38 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "portal",
  4. "version": "0.1.0",
  5. "description": "Official Spotify Portal plugin marketplace for AI coding tools.",
  6. "owner": {
  7. "name": "Spotify Portal"
  8. },
  9. "plugins": [
  10. {
  11. "name": "portal",
  12. "description": "Set up, diagnose, search, and operate Spotify Portal through focused Portal CLI workflows.",
  13. "version": "0.1.0",
  14. "author": {
  15. "name": "Spotify Portal"
  16. },
  17. "homepage": "https://backstage.spotify.com/docs/portal",
  18. "repository": "https://github.com/spotify/portal-ai-plugins",
  19. "source": {
  20. "source": "url",
  21. "url": "https://github.com/spotify/portal-ai-plugins.git"
  22. },
  23. "category": "developer-tools"
  24. },
  25. {
  26. "name": "shunt",
  27. "description": "Shunts I/O-heavy work to AiKA modes to save tokens. Hooks block large file reads and redirect to bulk-reader/code-writer scripts backed by the Portal CLI.",
  28. "version": "0.2.0",
  29. "author": {
  30. "name": "Spotify"
  31. },
  32. "homepage": "https://backstage.spotify.com/docs/portal",
  33. "repository": "https://github.com/spotify/portal-ai-plugins",
  34. "source": "./plugins/shunt",
  35. "category": "developer-tools"
  36. }
  37. ]
  38. }
README.md · README · 93 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Spotify Portal AI Plugins
  2. Bring [Spotify Portal](https://portal.spotify.com) into Claude Code, Codex, Cursor, and pi.
  3. This plugin provides focused workflows for the
  4. [Portal CLI](https://www.npmjs.com/package/@spotify/portal-cli): set up
  5. authentication, search your software catalog, build service briefings, run
  6. diagnostics, and invoke Portal actions.
  7. ## Highlights
  8. - Set up the Portal CLI for your current coding-agent environment.
  9. - Run read-only diagnostics to verify plugin, CLI, authentication, and action readiness.
  10. - Search the software catalog and technical documentation using natural language queries.
  11. - Generate concise service briefings with available ownership, health, incident, and documentation details.
  12. - Discover and safely invoke Portal actions with built-in help, dry-run, and confirmation safeguards.
  13. - Create, run, check, and troubleshoot Fleetshift shifts, open PRs from completed runs, and stop a run on request.
  14. The marketplace also ships **shunt** (Claude Code only for now): a plugin that routes I/O-heavy agent work — bulk file reads and boilerplate generation — to AiKA modes running cheaper worker models, via the Portal CLI actions registry. See [`plugins/shunt/README.md`](plugins/shunt/README.md).
  15. ## Installation
  16. ### Claude Code
  17. ```bash
  18. claude plugin marketplace add spotify/portal-ai-plugins
  19. claude plugin install portal@portal
  20. claude plugin install shunt@portal # optional: token-saving AiKA delegation
  21. ```
  22. Start a new session and run:
  23. ```text
  24. /portal:setup
  25. ```
  26. ### Codex
  27. ```bash
  28. codex plugin marketplace add spotify/portal-ai-plugins
  29. codex
  30. ```
  31. Open `/plugins`, install Spotify Portal, start a new task, and ask:
  32. ```text
  33. Set up Spotify Portal for me.
  34. ```
  35. ### Cursor
  36. Register the [spotify/portal-ai-plugins](https://github.com/spotify/portal-ai-plugins)
  37. repository in your Cursor team marketplace, then install Spotify Portal from
  38. **Cursor Settings → Plugins**.
  39. ### pi
  40. ```bash
  41. pi install git:github.com/spotify/portal-ai-plugins
  42. ```
  43. Start a new session and run:
  44. ```text
  45. /skill:setup
  46. ```
  47. ## Workflows
  48. | Workflow | Purpose |
  49. | --- | --- |
  50. | `setup` | Configure Portal CLI authentication |
  51. | `doctor` | Run read-only readiness diagnostics |
  52. | `search` | Search the software catalog and technical documentation |
  53. | `service` | Produce a concise operational service briefing |
  54. | `actions` | Discover, inspect, preview, and safely invoke Portal actions |
  55. | `feedback` | Submit feedback about the Portal CLI to the Portal team |
  56. | `fleetshift-create-shift` | Draft and create a Fleetshift shift from a goal, with a dry-run preview |
  57. | `fleetshift-run-shift` | Trigger a shift, monitor it with a bounded wait, and stop it on request |
  58. | `fleetshift-check-shift` | Report a shift's progress, targets, and PRs (read-only) |
  59. | `fleetshift-troubleshoot-shift` | Diagnose failed shift jobs from their status and logs (read-only) |
  60. | `fleetshift-create-prs` | Open PRs for completed shift targets after confirmation |
  61. ## Portal CLI
  62. The workflows invoke the upstream CLI through:
  63. ```bash
  64. npx @spotify/portal-cli <command>
  65. ```
  66. Setup verifies the required `auth`, `actions`, `owner`, `search`, and `service`
  67. commands before proceeding.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.