portal
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.
Badge for your README
Markdown
[](/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)
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "portal",
- "version": "0.1.0",
- "description": "Official Spotify Portal plugin marketplace for AI coding tools.",
- "owner": {
- "name": "Spotify Portal"
- },
- "plugins": [
- {
- "name": "portal",
- "description": "Set up, diagnose, search, and operate Spotify Portal through focused Portal CLI workflows.",
- "version": "0.1.0",
- "author": {
- "name": "Spotify Portal"
- },
- "homepage": "https://backstage.spotify.com/docs/portal",
- "repository": "https://github.com/spotify/portal-ai-plugins",
- "source": {
- "source": "url",
- "url": "https://github.com/spotify/portal-ai-plugins.git"
- },
- "category": "developer-tools"
- },
- {
- "name": "shunt",
- "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.",
- "version": "0.2.0",
- "author": {
- "name": "Spotify"
- },
- "homepage": "https://backstage.spotify.com/docs/portal",
- "repository": "https://github.com/spotify/portal-ai-plugins",
- "source": "./plugins/shunt",
- "category": "developer-tools"
- }
- ]
- }
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)
- # Spotify Portal AI Plugins
- Bring [Spotify Portal](https://portal.spotify.com) into Claude Code, Codex, Cursor, and pi.
- This plugin provides focused workflows for the
- [Portal CLI](https://www.npmjs.com/package/@spotify/portal-cli): set up
- authentication, search your software catalog, build service briefings, run
- diagnostics, and invoke Portal actions.
- ## Highlights
- - Set up the Portal CLI for your current coding-agent environment.
- - Run read-only diagnostics to verify plugin, CLI, authentication, and action readiness.
- - Search the software catalog and technical documentation using natural language queries.
- - Generate concise service briefings with available ownership, health, incident, and documentation details.
- - Discover and safely invoke Portal actions with built-in help, dry-run, and confirmation safeguards.
- - Create, run, check, and troubleshoot Fleetshift shifts, open PRs from completed runs, and stop a run on request.
- 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).
- ## Installation
- ### Claude Code
- ```bash
- 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:
- ```text
- /portal:setup
- ```
- ### Codex
- ```bash
- codex plugin marketplace add spotify/portal-ai-plugins
- codex
- ```
- Open `/plugins`, install Spotify Portal, start a new task, and ask:
- ```text
- 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
- ```bash
- pi install git:github.com/spotify/portal-ai-plugins
- ```
- Start a new session and run:
- ```text
- /skill:setup
- ```
- ## Workflows
- | Workflow | Purpose |
- | --- | --- |
- | `setup` | Configure Portal CLI authentication |
- | `doctor` | Run read-only readiness diagnostics |
- | `search` | Search the software catalog and technical documentation |
- | `service` | Produce a concise operational service briefing |
- | `actions` | Discover, inspect, preview, and safely invoke Portal actions |
- | `feedback` | Submit feedback about the Portal CLI to the Portal team |
- | `fleetshift-create-shift` | Draft and create a Fleetshift shift from a goal, with a dry-run preview |
- | `fleetshift-run-shift` | Trigger a shift, monitor it with a bounded wait, and stop it on request |
- | `fleetshift-check-shift` | Report a shift's progress, targets, and PRs (read-only) |
- | `fleetshift-troubleshoot-shift` | Diagnose failed shift jobs from their status and logs (read-only) |
- | `fleetshift-create-prs` | Open PRs for completed shift targets after confirmation |
- ## Portal CLI
- The workflows invoke the upstream CLI through:
- ```bash
- npx @spotify/portal-cli <command>
- ```
- Setup verifies the required `auth`, `actions`, `owner`, `search`, and `service`
- commands before proceeding.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.