Skip to content
Skills Library
Other · Analysis

doctor

/doctor

Diagnose Spotify Portal plugin, CLI, authentication, and action access without changing state. Use when setup is failing, commands are missing, authentication is unclear, a plugin update looks stale, or the user asks whether Portal is ready.

Licence
Apache-2.0
Last repository change
23.10.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Diagnose Spotify Portal plugin, CLI, authentication, and action access without changing state. Use when setup is failing, commands are missing, authentication is unclear, a plugin update looks stale, or the user asks whether Portal is ready.

Original author description

Diagnose Spotify Portal plugin, CLI, authentication, and action access without changing state. Use when setup is failing, commands are missing, authentication is unclear, a plugin update looks stale, or the user asks whether Portal is ready.

How it works

  1. Diagnostic workflow
  2. Report
Original SKILL.md headings · 75 lines, 360 words
SKILL.md preview
---
name: doctor
description: Diagnose Spotify Portal plugin, CLI, authentication, and action access without changing state. Use when setup is failing, commands are missing, authentication is unclear, a plugin update looks stale, or the user asks whether Portal is ready.
---

# Diagnose Spotify Portal

Run a read-only health check for the current coding-agent host. Do not install,
authenticate, select an instance, or invoke a mutating Portal action.

## Diagnostic workflow

### 1. Inspect the host plugin

Use only the command for the current host:

```bash
claude plugin list --json
codex plugin list --available --json
```

In Cursor, inspect the installed plugin through **Cursor Settings → Plugins**.
Do not assume a Cursor plugin-list CLI command exists.

Confirm whether `portal` is installed and enabled, and record its
reported version. If the installed version is current but the visible commands
have older descriptions, recommend `/reload-plugins` in Claude Code or a new
session in the current host.

Run the corresponding plugin command with `--help` first if its JSON syntax is
not supported by the installed host version.

### 2. Verify the CLI runtime and command surface

```bash
node --version
npm --version
npx @spotify/portal-cli --help
npx @spotify/portal-cli auth --help
```

The CLI should expose `auth`, `actions`, `owner`, `search`, and `service`.
Report missing commands as a CLI-version blocker.

### 3. Inspect authentication without changing selection

```bash
npx @spotify/portal-cli auth list
npx @spotify/portal-cli auth show
```

When the user supplied an instance name, inspect it with the documented
`auth show` instance flag. When multiple instances exist and no target was
provided, report the ambiguity instead of selecting one.

Never request or print credentials, tokens, or authorization codes.

### 4. Verify read-only Portal access

```bash
npx @spotify/portal-cli actions list --json
```

Treat success as evidence that the CLI can authenticate, reach the selected
instance, and enumerate the user's available actions. Do not invoke an action.

## Report

Return a compact table with these checks:

| Check | Status | Evidence or next action |
| --- | --- | --- |
| Plugin | Ready, warning, or blocked | Installed version and reload guidance |
| CLI | Ready or blocked | Runtime and required command surface |
| Authentication | Ready, ambiguous, or blocked | Instance name and backend URL |
| Actions | Ready or blocked | Result of `actions list --json` |

Do not report overall readiness when a required check is blocked or unverified.

Versions

RepositoryScoreLicence
This page · spotify/portal-ai-plugins95Apache-2.0
dithiothreitol/jdg-ksiegowy100MIT
yonatangross/orchestkit100MIT
yonatangross/orchestkit100MIT
joris887/exosuit100MIT
crisandrews/clawcode100MIT
clockgrove/factory100MIT
r3dlex/oh-my-auggie100Apache-2.0
stxrmik/antigravity-plus100MIT

Database snapshot: 13.11.2026 · package version 6cb6390c294d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100setup
    Set up, authenticate, and verify Spotify Portal for the current coding agent. Use when the user asks to install or connect Portal, authenticate the Portal CLI, select a Portal instance, or verify CLI access.
  • 100feedback
    Submit feedback about the Spotify Portal CLI to the Portal team. Use when the user explicitly asks to send CLI feedback, or voices an impression, complaint, suggestion, or praise about the Portal CLI or these Portal workflows and confirms they want it submitted.
  • 1003gpp-portal-authentication
    EOL authentication, AJAX login patterns, 3GPP portal data fetching, and session management. Use when accessing protected 3GPP portal resources that require EOL login, fetching TDoc metadata, or working with 3GPP portal APIs.
  • 96rustdesk-doctor
    诊断 RustDesk 连接问题。当用户说 RustDesk 连不上、无法远程、ID 不显示、注册失败时使用
  • 100ops-doctor
    OPS on-demand: This skill should be used when the user asks to \"plugin broken\", \"ops doctor\", or…
  • 95spotify-ads-api-reference
    This skill should be used when the user asks to "call the Spotify Ads API", "create a Spotify ad campaign", "manage Spotify ads", "pull Spotify ad reports", "set up ad sets or ads", "upload ad assets", "target audiences on Spotify", "check campaign status", "get ad account…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.