claude-code-spec-sync

Tracks Claude Code changelog releases and updates project rules, skills, hooks, and settings accordingly.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/kai-kou/gem-hunter --skill claude-code-spec-sync-kai-kou
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-code-spec-sync
Source: https://github.com/kai-kou/gem-hunter/tree/main/.claude/skills/claude-code-spec-sync
Command: npx skills add https://github.com/kai-kou/gem-hunter --skill claude-code-spec-sync-kai-kou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Claude Code updates frequently, and breaking changes can silently break existing hooks, skill definitions, and settings. This Skill orchestrates a lane that catches up on Claude Code version changes and keeps the project's internal configuration assets aligned with the latest specification. ## Core Features & Use Cases - Two-speed follow-up: Breaking changes trigger an immediate response flow (impact investigation → fix → PR → merge), while new features and settings go through a verification and deliberation phase via Issues before adoption. - Detection and triage: Runs tools/check_claude_code_updates.py to detect new versions, classify changes, create Issues, and run a permission probe script to catch behavior changes that keyword dictionaries miss. - Cross-cutting impact analysis: Greps rules files, SKILL.md definitions, hooks, settings.json, and headless claude -p call sites for affected commands, flags, and environment variables. - Use Case: A scheduled slot detects a new Claude Code release with a breaking hook change; the Skill locks the Issue, verifies the official changelog, fixes the affected hook with a minimal diff, opens a PR, and marks the version as known to prevent re-detection loops. ## Quick Start Ask the AI to run /claude-code-spec-sync or say "follow up on Claude Code spec changes" to check for new releases and process any pending lane Issues.

Frequently Asked Questions about claude-code-spec-sync

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

FAQPage Schema
How do I keep Claude Code hooks and settings up to date after version upgrades?▼

Run the spec-sync lane, which detects new Claude Code versions via a Python script, classifies changes as breaking or new features, and updates rules, skills, hooks, and settings through a PR-based workflow.

How are breaking changes in Claude Code releases handled?▼

Breaking changes trigger an immediate response flow: the Issue is locked, the official changelog and docs are verified, affected files are found via cross-cutting Grep, a minimal fix is made, and a PR is merged in the same session.

Does this workflow apply new Claude Code features automatically?▼

No. New features and settings go through a verification phase as Issues, where official docs are checked, adoption value is evaluated, and large-impact changes may go through a discussion review before adoption or rejection.

What happens if GitHub CLI is unavailable in a cloud session?▼

The gh commands in the Skill are local-only; in cloud environments they are replaced with mcp__github__* tools. After handling, the version is marked known with --mark-known to prevent infinite re-detection loops.

What changes are never applied automatically by this lane?▼

Changes touching permissions.deny in settings.json or the A-1 to A-6 boundaries are never auto-applied; the verification Issue is labeled status:waiting-user for a human decision. Changes not verifiable against official sources are also not applied.