Agent skill

Changeset Doc Sync

by udecode in udecode/kitcn

Read every doc in www and packages/kitcn/skills/kitcn, sync to active changeset(s), and track with checkmarks.

Apache-2.0Auto-check passedDevelopment

Install Changeset Doc Sync

skills CLI
$ npx skills add udecode/kitcn --skill changeset-doc-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install udecode/kitcn changeset-doc-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/udecode/kitcn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/changeset-doc-sync .claude/skills/changeset-doc-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
changeset-doc-sync
GitHub stars
450
Token cost
~1.2k tokens
SKILL.md length
358 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
Apache-2.0

At a glance

Read every doc in www and packages/kitcn/skills/kitcn, sync to active changeset(s), and track with checkmarks.

  • Works in 6 steps: Run preflight migration review from… → Run autogoal planning first → Resolve active changeset target(s) → …
  • Development work in your project
  • SKILL.md covers Mandatory sequence, Non-negotiable checklist rules, Goal plan checklist template… and Checklist template, plus 1 more section
  • Calls git and node

What it does

Changeset Doc Sync is an agent skill from udecode/kitcn. Read every doc in www and packages/kitcn/skills/kitcn, sync to active changeset(s), and track with checkmarks.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Git. The repository describes itself as: Convex + Better Auth + tRPC + Drizzle + TanStack Query + shadcn. The licence is Apache-2.0.

When your agent uses it

  • Development work in your project

Example prompts

  • “/changeset-doc-sync”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Run preflight migration review from /example before docs sync
  2. Run autogoal planning first
  3. Resolve active changeset target(s)
  4. Build execution checklists in the goal plan
  5. Read every listed doc and sync
  6. Completion gates

What it can do on your machine

Read from SKILL.md and the folder at commit c6010f5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Changeset Doc Sync loads about 1.2k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 358 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from udecode/kitcn at commit c6010f5, republished under its Apache-2.0 licence (© udecode). 358 words, ~1,219 tokens.

Download SKILL.mdSave it as .claude/skills/changeset-doc-sync/SKILL.md (or your agent's skills folder).
name
changeset-doc-sync
description
Read every doc in www and packages/kitcn/skills/kitcn, sync to active changeset(s), and track with checkmarks.

Changeset Doc Sync

Use this workflow when release docs must match current changeset content.

Mandatory sequence

  1. Run preflight migration review from /example before docs sync:

    • git diff --name-only -- example
    • git diff --stat -- example
    • git diff -- example
    • Save migration conclusions in the active docs/plans/<date>-changeset-doc-sync.md.
    • Mandatory: build a /example change checklist in that goal plan with one checkbox per changed file.
    • For each changed /example file, record:
      • impacted doc file(s), or
      • explicit no doc impact justification.
  2. Run autogoal planning first:

    • Create or continue one docs/plans/<date>-changeset-doc-sync.md goal plan.
    • Use node .agents/skills/autogoal/scripts/create-goal-scratchpad.mjs --template task --title "changeset doc sync" when creating a new plan.
    • Mandatory: the goal plan must include an exhaustive per-file checklist (every target doc as its own - [ ] item).
  3. Resolve active changeset target(s):

    • List .changeset/*.md excluding .changeset/README.md.
    • Use changed changeset file(s) in the branch.
    • Extract breaking/features/patches and migration snippets.
  4. Build execution checklists in the goal plan:

    • Include every file in:
      • www/**/*.md
      • www/**/*.mdx
      • packages/kitcn/skills/kitcn/**/*.md
    • Keep /example crosswalk checklist in the goal plan in sync during the run.
  5. Read every listed doc and sync:

    • Update docs where migration changes are required.
    • Mark every file checked once synced.
    • If unchanged, still check with note no change needed.
    • For each /example changed file, mark the corresponding crosswalk checkbox only after linked docs are verified.
  6. Completion gates:

    • /example crosswalk in the goal plan has zero unchecked file items.
    • The goal plan has zero unchecked file items.
    • No unchecked items remain.
    • The goal plan logs scanned/updated/unchanged totals.
    • The goal plan maps key doc edits to concrete changeset bullets.
    • node .agents/skills/autogoal/scripts/check-complete.mjs docs/plans/<date>-changeset-doc-sync.md passes.
Show full SKILL.md (99 more words)Show less

Non-negotiable checklist rules

  1. Do not summarize file coverage in the goal plan (for example, "56 files scanned").
    You must list each file explicitly with its own checkbox.
  2. Every processed file must be marked:
    • updated, or
    • no change needed
  3. A run is incomplete if even one file remains unchecked in either checklist.
  4. Any changed /example file without a mapped doc check or no doc impact note is a hard failure.
  5. Do not close the run until /example diff, changeset bullets, and updated docs are all cross-referenced.

Goal plan checklist template (required)

md
### Phase: Doc Sync Checklist (www)

- [ ] `www/content/docs/a.mdx` — pending
- [ ] `www/content/docs/b.mdx` — pending

### Phase: Doc Sync Checklist (packages/kitcn/skills/kitcn)

- [ ] `packages/kitcn/skills/kitcn/SKILL.md` — pending
- [ ] `packages/kitcn/skills/kitcn/references/setup/index.md` — pending

### Phase: /example-to-doc Crosswalk (required)

- [ ] `example/convex/shared/api.ts` -> `www/content/docs/cli/backend.mdx`, `www/content/docs/react/infer-types.mdx` — pending
- [ ] `example/src/lib/convex/crpc.tsx` -> `www/content/docs/react/index.mdx` — pending
- [ ] `example/src/lib/convex/rsc.tsx` -> `www/content/docs/nextjs/index.mdx`, `www/content/docs/server/server-side-calls.mdx` — pending
- [ ] `example/src/lib/convex/server.ts` -> `www/content/docs/nextjs/index.mdx` — pending
- [ ] `example/convex/functions/http.ts` -> `www/content/docs/server/http.mdx` — pending
- [ ] `example/convex/shared/types-typecheck.ts` -> `www/content/docs/react/infer-types.mdx` — pending

Checklist template

md
# Doc Sync Checklist

## Changesets

- [x] `.changeset/your-file.md`

## www docs

- [ ] `www/path/to/doc.mdx` — pending

## packages/kitcn/skills/kitcn docs

- [ ] `packages/kitcn/skills/kitcn/SKILL.md` — pending
- [ ] `packages/kitcn/skills/kitcn/references/setup/index.md` — pending

## Synced

- [x] `www/path/to/doc.mdx` — updated for `@convex/api` migration
- [x] `packages/kitcn/skills/kitcn/references/setup/index.md` — no change needed

Suggested commands

bash
git diff --name-only -- example
git diff --stat -- example
git diff -- example
find .changeset -maxdepth 1 -type f -name '*.md' ! -name 'README.md' | sort
find www -type f \( -name '*.md' -o -name '*.mdx' \) | sort
{ echo 'packages/kitcn/skills/kitcn/SKILL.md'; find packages/kitcn/skills/kitcn/references -type f -name '*.md' | sort; }

© udecode, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/changeset-doc-sync of udecode/kitcn.

Open the folder on GitHubat commit c6010f5

Compare with similar skills

Changeset Doc Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Changeset Doc Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Changeset Doc Sync this skilludecode/kitcn450—~1.2kAutomated safety check: PassApache-2.0
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything85k1 repos~1.2kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Understand Diff AnalysisEgonex-AI/Understand-Anything85k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Codebase Knowledge Graph Q&A

    Egonex-AI/Understand-Anything

    Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.

    85k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    85k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Understand Explain

    Egonex-AI/Understand-Anything

    Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.

    85k GitHub starsUsed in 1 repo~1.3k tokens
    DevelopmentAuto-check passed

More from udecode/kitcn

All 33 skills in this repo
  • Walkthrough

    udecode/kitcn

    Create a short annotated visual walkthrough from real final-state screenshots or rendered artifacts.

    450 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Avoid Feature Creep

    udecode/kitcn

    Prevent feature creep when building software, apps, and AI-powered products.

    450 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Changeset Resolve

    udecode/kitcn

    Repair an unreleased .changeset/.md file so it matches the real branch delta against main.

    450 GitHub stars~922 tokensUpdated 6 days ago
    Auto-check passed
  • Audit newer Convex npm releases against kitcn. An agent skill from udecode/kitcn.

    450 GitHub stars~1.8k tokensUpdated 6 days ago
    Auto-check passed
  • Jotai X

    udecode/kitcn

    A skill your agent uses when working with Jotai X stores (createAtomStore), accessing state in components or callbacks, persisting state to cookies or localStorage

    450 GitHub stars~3.7k tokensUpdated 6 days ago
    Auto-check passed
  • Linear Backlog

    udecode/kitcn

    Run a scoped Linear backlog autonomously as a sequence of maximal safe parallel batches by composing orchestrator, autogoal, and task.

    450 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed

Works with

Categories

Questions about Changeset Doc Sync

What does Changeset Doc Sync do?

Read every doc in www and packages/kitcn/skills/kitcn, sync to active changeset(s), and track with checkmarks. Changeset Doc Sync is an agent skill from udecode/kitcn. Read every doc in www and packages/kitcn/skills/kitcn, sync to active changeset(s), and track with checkmarks.

When should I use Changeset Doc Sync?

Changeset Doc Sync fits situations like: development work in your project.

How do I install Changeset Doc Sync in Claude Code?

Run `npx skills add udecode/kitcn --skill changeset-doc-sync -a claude-code`. Or copy the skill folder (.agents/skills/changeset-doc-sync in udecode/kitcn) into .claude/skills/changeset-doc-sync in your project. Claude Code loads it when a task matches its description.

How do I install Changeset Doc Sync in Codex?

Run `npx skills add udecode/kitcn --skill changeset-doc-sync -a codex`. Or copy the skill folder (.agents/skills/changeset-doc-sync in udecode/kitcn) into .agents/skills/changeset-doc-sync in your project. Codex loads it when a task matches its description.

Can I use Changeset Doc Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add udecode/kitcn --skill changeset-doc-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/changeset-doc-sync, .gemini/skills/changeset-doc-sync, .github/skills/changeset-doc-sync and .opencode/skills/changeset-doc-sync in your project.

What does Changeset Doc Sync need to run?

Going by SKILL.md and its folder, Changeset Doc Sync needs the command-line tools its instructions call (git and node).

Does Changeset Doc Sync access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Changeset Doc Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Changeset Doc Sync use?

Changeset Doc Sync is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Changeset Doc Sync use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Changeset Doc Sync?

Skills that share tags, products or a category with Changeset Doc Sync: Finishing a Development Branch (obra/superpowers, 296k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 85k stars) and Code Design Rationale Investigator (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Changeset Doc Sync?

udecode (a GitHub organization) maintains it in udecode/kitcn, which has 450 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 1, 2026.

Source: udecode/kitcn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.