skills.rest
Priivacy-ai
Priivacy-aiOFFICIAL
Explore all skills by this author →
GitHub

spk-team-auth

Diagnose and resolve Spec Kitty hosted team authentication and account access issues.

1.6k|156|Updated Oct 9, 2025
Search Tags:#CLI#credentials#Troubleshooting#Authentication#spec-kitty#hosted sync#team account
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-team-auth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spk-team-auth
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-team-auth
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-team-auth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When Spec Kitty sync or tracker workflows fail due to login, hosted credentials, or team account problems, this Skill provides a structured flow to identify the auth mode, run the right status commands, and route failures to the correct recovery path.

Core Features & Use Cases

  • Auth Mode Detection: Distinguishes local-only mode from hosted team mode before running diagnostics.
  • Failure Routing: Sends tracker-specific failures to spk-team-tracker and sync transport failures to spk-team-sync.
  • Hosted Mode Setup: Guides enabling hosted sync via SPEC_KITTY_ENABLE_SAAS_SYNC=1 in .kittify/.kitty.env or ${SPEC_KITTY_HOME}/.kitty.env, verified with spec-kitty doctor env-file.
  • Use Case: A developer sees sync failing after switching team accounts; the Skill runs the auth status command, captures exact output, and determines whether the issue is credentials, tracker, or transport.

Quick Start

Ask the assistant to check why Spec Kitty hosted sync login is failing and which account or auth mode is currently active.

Frequently Asked Questions about spk-team-auth

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Spec Kitty login or hosted auth failures?▼

First identify whether the command runs in local-only or hosted team mode, then run the relevant auth status command and capture its exact output. Tracker failures route to spk-team-tracker and sync transport failures route to spk-team-sync.

How to enable hosted team mode in Spec Kitty CLI?▼

Set SPEC_KITTY_ENABLE_SAAS_SYNC=1 in .kittify/.kitty.env for repo-scoped opt-in or in ${SPEC_KITTY_HOME}/.kitty.env for machine-wide opt-in. Run spec-kitty doctor env-file to confirm which tier is active.

Why should I avoid exporting SPEC_KITTY_ENABLE_SAAS_SYNC in my shell?▼

A shell export arms every project that shell subsequently touches, not just the one being tested. Writing the variable once into a .kitty.env file scopes hosted mode to the intended repo or machine instead.

When are auth errors actually tracker or sync problems?▼

If the auth status output shows valid credentials but operations still fail, the cause is likely tracker-specific or sync transport related. Those cases are routed to spk-team-tracker or spk-team-sync respectively rather than re-authenticating.

What information do I need to provide during auth recovery?▼

Only credentials or account decisions that cannot be inferred from the environment are requested. The flow captures command output first so most context comes from the CLI rather than manual input.

Related Skills

Explore More Software Engineering Skills→
kimprobablykimprobably

spec-kitty-setup-doctor

Diagnose and recover broken Spec Kitty installations using verification commands.

Community
Advanced
jeremy-newhousejeremy-newhouse

wa:dev-sprint

Execute tracker-defined engineering sprints in dependency order with state recovery.

Community
Advanced
k1064190k1064190
2

toss-sync

Synchronize Toss Securities portfolios into a local tracker via Toss Open API or tossctl CLI.

Community
Intermediate
richfremrichfrem
5

spec-kitty-sync-plugin

Synchronize and upgrade Spec-Kitty CLI, templates, and plugin while preserving custom knowledge.

Community
Advanced