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

spk-team-sync

Operates Spec Kitty hosted sync, offline queue, diagnostics, and recovery flows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams using Spec Kitty need a consistent way to manage hosted SaaS synchronization, offline queues, and sync failures without losing mission data or breaking local state. This Skill routes sync-related commands through the correct diagnostics, recovery, and escalation paths.

Core Features & Use Cases

  • Sync Diagnostics: Runs status and diagnostic checks before any repair command so problems are identified before they are fixed.
  • Offline Queue & Recovery: Handles offline queue operations and recovery flows for hosted sync interruptions.
  • Routing to Related Flows: Directs tracker-bound sync to spk-team-tracker and authentication failures to spk-team-auth.
  • Use Case: A developer's hosted sync stops updating team state. The Skill first runs sync diagnostics, checks the offline queue, and either repairs the sync or routes the auth failure to the correct handler while preserving JSON output.

Quick Start

Ask the assistant to check Spec Kitty hosted sync status and diagnose why team state is not updating.

Frequently Asked Questions about spk-team-sync

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

FAQPage Schema
How do I diagnose Spec Kitty hosted sync problems?▼

Run sync status and diagnostics commands before attempting any repair. The Skill checks hosted sync state and the offline queue first, then applies recovery flows only after the root cause is identified.

How do I enable hosted SaaS sync in Spec Kitty for local testing?▼

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

What happens when Spec Kitty sync hits an authentication failure?▼

Authentication failures are routed to the spk-team-auth skill rather than handled inline. This keeps credential and login concerns separate from sync diagnostics and recovery logic.

Does Spec Kitty sync work offline?▼

Yes, Spec Kitty maintains an offline queue for sync operations when hosted connectivity is unavailable. The Skill manages this queue and replays or recovers pending operations during sync recovery flows.

Why should I avoid exporting SPEC_KITTY_ENABLE_SAAS_SYNC in my shell?▼

A shell export arms hosted sync for every project that shell touches, not just the one being tested. Writing the variable to a repo-scoped or machine-wide .kitty.env file confines the effect to the intended scope.

Related Skills

Explore More Software Engineering Skills→
kimprobablykimprobably

spec-kitty-setup-doctor

Diagnose and recover broken Spec Kitty installations using verification commands.

Community
Advanced
MathieuDoyonMathieuDoyon

mission-kanban

Decomposes multi-part mission objectives into kanban tasks and routes the next sub-skill.

Community
Intermediate
hongmaple0820hongmaple0820
9

managing-secrets

Automate centralized secret management across Vault, cloud providers, and Kubernetes.

Community
Advanced
richfremrichfrem
5

spec-kitty-sync-plugin

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

Community
Advanced