spk-team-tracker

Operates Spec Kitty tracker workflows including service discovery, binding, hosted routing, and recovery.

1.6k|156|Updated Oct 9, 2025
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-team-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spk-team-tracker
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-team-tracker
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-team-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams using Spec Kitty need a consistent way to configure, bind, and diagnose tracker integrations without guessing which sync mode or routing path is active, especially when hosted sync and local CLI behavior diverge.

Core Features & Use Cases

  • Tracker Status Inspection: Reviews tracker status and service discovery output to confirm the active project and tracker binding.
  • Hosted Sync Routing: Enables hosted sync only when the workflow requires it, and routes auth failures to spk-team-auth and transport or offline replay failures to spk-team-sync.
  • Local Dev Configuration: Guides opting into hosted mode with SPEC_KITTY_ENABLE_SAAS_SYNC=1 via .kittify/.kitty.env or ${SPEC_KITTY_HOME}/.kitty.env, verified with spec-kitty doctor env-file.
  • Use Case: A developer testing tracker sync locally writes the env flag into the repo-scoped .kitty.env file, runs spec-kitty doctor env-file to confirm the active tier, and diagnoses a binding mismatch before pushing work.

Quick Start

Ask the assistant to check the current Spec Kitty tracker status and confirm which project and tracker binding are active.

Frequently Asked Questions about spk-team-tracker

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

FAQPage Schema
How do I set up tracker sync in Spec Kitty?

Tracker setup starts by inspecting tracker status and service discovery output, then confirming the active project and tracker binding. Hosted sync should only be enabled when the workflow explicitly requires it.

How do I enable hosted tracker mode for local Spec Kitty testing?

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 flag into a .kitty.env file scopes hosted mode to the intended repo or machine tier instead.

What happens when Spec Kitty tracker auth fails?

Authentication failures during tracker operations are routed to the spk-team-auth skill for handling. Transport or offline replay failures are routed separately to the spk-team-sync skill.

How do I diagnose which Spec Kitty tracker tier is active?

Run spec-kitty doctor env-file to confirm whether the repo-scoped or machine-wide configuration tier is active. This verifies where the hosted sync flag is being read from before troubleshooting further.