mralexsaavedra/spotiarr/spotiarr-workflow

Claude Code and agent skill by mralexsaavedra/spotiarr

Trust tier 2
  • community
  • ext:[{"type":"hook","description":"Pre/post lifecycle hooks"}]
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Trigger: command, validate, PR, branch, run lint, run build, secrets. Correct pnpm commands, branch naming, PR checklist, and secrets rules for spotiarr.

Install

npx vskill@latest install mralexsaavedra/spotiarr/spotiarr-workflow

Semi-extensibleMentions customization, but needs skill-specific knowledge. Read the extensible skills standard

SKILL.md

Activation Contract

Load when running commands, validating changes, creating PRs, managing branches, or checking secrets.

Hard Rules

  • CI runs lint, tests, and build as separate jobs. Automated tests cover backend and frontend utilities.
  • Never commit .env, tokens, or credentials. Use .env.example as source of truth.
  • SPOTIARR_TOKEN (instance auth token) is a secret — treat like a password, never hardcode or log it. Generate with openssl rand -base64 32.
  • Cover new code with tests — services, query/mutation hooks, components, middleware, and utils all get unit tests. The absence of a sibling test is NOT a reason to skip; being the first test of its kind is fine.
  • Never bypass pre-commit hooks (--no-verify is forbidden).
  • External services required locally: Redis, FFmpeg, yt-dlp, Python 3.11/3.12.

Decision Gates

ScopeValidate with
Frontend onlypnpm --filter frontend run lint → pnpm --filter frontend run test:run → pnpm --filter frontend run build
Backend onlypnpm --filter backend run lint → pnpm --filter backend run test:run → pnpm --filter backend run build
Shared or cross-workspacepnpm lint → pnpm test → pnpm build

Execution Steps

Branch naming:

TypePrefixExample
Featurefeature/feature/add-playback-retry
Fixfix/fix/sse-reconnect-loop
Refactorrefactor/refactor/backend-di-wiring
Docsdocs/docs/update-env-guide
Chorechore/chore/bump-deps

PR checklist: branch up to date with main · lint + build passing · PR body has what/why/verification · screenshots for UI changes.

PR sizing policy:

SituationAction
Slice over 400 LOCDefault: split into chained-to-main PRs (see chained-pr skill).
ask-on-riskOnly when the requester explicitly asks to be consulted before splitting.
size:exceptionReserved for irreducible atomic refactors that cannot be split without breaking review or correctness. Label the PR and justify in the body.

The 400 LOC threshold protects review focus. Prefer many small, sequentially reviewable PRs over one oversized PR. size:exception is the rare escape hatch, not a routine option.

Key commands:

bash
pnpm dev                                    # full dev stack
pnpm lint && pnpm test && pnpm build        # broad validation
pnpm test                                   # all workspace tests
pnpm --filter frontend run test:run         # frontend unit tests
pnpm --filter backend run test:run          # backend unit tests
pnpm --filter backend run prisma:migrate:deploy
gh pr create                                # title must follow Conventional Commits

Security

  • Security scanPassed, 93 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
35
Repository forks
6
7-day trend score
18

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Extension points

  • hookPre/post lifecycle hooks

Learn the extensible skills standard

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/mralexsaavedra/spotiarr/spotiarr-workflow/badge)](https://verified-skill.com/skills/mralexsaavedra/spotiarr/spotiarr-workflow)

Something wrong with this skill or its page? Tell us.