# Spk Team Auth

> Handle Spec Kitty team authentication, hosted credentials, account selection, and auth-related recovery.

- Skill: `spec-kitty/spk-team-auth` (Agent Skill)
- Install (CLI): `npx skillmds@latest add spec-kitty/spk-team-auth`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spec-kitty/spk-team-auth/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spec-kitty (https://skillmd.com/u/spec-kitty)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spec-kitty/spk-team-auth

---


# spk-team-auth

Use this skill when the user asks about login, hosted auth, team account access,
or auth failures in sync/tracker workflows.

## Flow

1. Identify whether the command uses local-only mode or hosted team mode.
2. Run the relevant auth/status command and capture exact output.
3. Route tracker-specific failures to `spk-team-tracker`.
4. Route sync transport failures to `spk-team-sync`.
5. Ask the user only for credentials or account decisions that cannot be
   inferred.

## Local Dev Note

When testing hosted auth from the CLI on this computer, set
`SPEC_KITTY_ENABLE_SAAS_SYNC=1`.