Skip to main content
ClaudeWave
Skill1.3k repo starsupdated today

spk-team-auth

The spk-team-auth skill manages Spec Kitty team authentication, including login flows, hosted credential handling, account selection, and auth-related troubleshooting for sync and tracker workflows. Use this skill when users encounter login failures, need to switch team accounts, or experience authentication issues during hosted mode operations.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/Priivacy-ai/spec-kitty /tmp/spk-team-auth && cp -r /tmp/spk-team-auth/src/doctrine/skills/spk-team-auth ~/.claude/skills/spk-team-auth
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 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`.