Agent skill

Pensieve Sync To Main

by kingkongshot in kingkongshot/Pensieve

Sync Pensieve's Chinese development/release branch into the English main branch.

MITAuto-check passedFrontend & Design

Install Pensieve Sync To Main

skills CLI
$ npx skills add kingkongshot/Pensieve --skill pensieve-sync-to-main -a claude-code

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

GitHub CLI
$ gh skill install kingkongshot/Pensieve pensieve-sync-to-main --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/kingkongshot/Pensieve.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/pensieve-sync-to-main .claude/skills/pensieve-sync-to-main && 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
pensieve-sync-to-main
GitHub stars
2.5k
Token cost
~1.1k tokens
SKILL.md length
459 words
Files
2
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Sync Pensieve's Chinese development/release branch into the English main branch.

  • Works in 4 steps: Confirm scope → Create sync branch → Translate → …
  • Asks to sync zh
  • SKILL.md covers Hard Rules, Branch Strategy, Translation Scope and Workflow, plus 1 more section
  • Calls git, rg and gh

What it does

Pensieve Sync To Main is an agent skill from kingkongshot/Pensieve. Sync Pensieve's Chinese development/release branch into the English main branch. Use in the Pensieve repository when the user asks to sync zh or experimental to main, publish the English branch, translate Pensieve README/tool specs/templates/SKILL.md, or run the zh-to-main release flow. Do not use for ordinary project localization or generic i18n.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Frontend & Design, covering Internationalization and Translation. The repository describes itself as: tore your decisions and principles. Claude reads them to make better choices. The licence is MIT.

When your agent uses it

  • Asks to sync zh
  • Experimental to main
  • Publish the English branch
  • Translate Pensieve README/tool specs/templates/SKILL.md

Example prompts

  • “/pensieve-sync-to-main”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Confirm scope
  2. Create sync branch
  3. Translate
  4. Validate, commit, and open PR

What it can do on your machine

Read from SKILL.md and the folder at commit 8731f61. 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
    • rg
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use git and gh, 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

Pensieve Sync To Main loads about 1.1k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 459 words of instructions outside code blocks.

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

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 kingkongshot/Pensieve at commit 8731f61, republished under its MIT licence (© kingkongshot). 459 words, ~1,145 tokens.

Download SKILL.mdSave it as .claude/skills/pensieve-sync-to-main/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pensieve-sync-to-main
description
Sync Pensieve's Chinese development/release branch into the English main branch. Use in the Pensieve repository when the user asks to sync zh or experimental to main, publish the English branch, translate Pensieve README/tool specs/templates/SKILL.md, or run the zh-to-main release flow. Do not use for ordinary project localization or generic i18n.

Pensieve Sync to Main

Use only inside the Pensieve repository itself.

This skill syncs changes from experimental or zh into main, preserves contributor history, and ensures main remains the English release branch. This is a maintainer release flow, not a default pipeline that should be seeded into every Pensieve user project.

Hard Rules

  • main must remain English-only and release-grade.
  • Preserve source-branch commit history; do not squash contributor history unless the user explicitly asks.
  • Code logic must stay identical across language branches; only text content may differ.
  • Do not translate code identifiers, paths, protocol names, command names, frontmatter keys, or Markdown link targets unless the branch rules below explicitly require it.
  • When the worktree has unrelated local changes, do not run destructive git cleanup commands.

Branch Strategy

  • experimental: development branch
  • zh: Chinese release branch
  • main: English release branch

Default source branch is zh unless the user explicitly specifies experimental. Default remote is kingkongshot.

Translation Scope

Chinese content in these files must be translated into English:

  • README.md
  • SKILL.md
  • .src/references/*.md
  • .src/tools/*.md
  • .src/templates/**/*.md

These files are synced directly by default; translate only if user-visible Chinese appears on the English branch:

  • Scripts and code
  • JSON/YAML configuration
  • Deleted files
  • Binary assets

Workflow

1. Confirm scope
  1. Check current state:
    bash
    git branch --show-current
    git status --short
    git remote -v
  2. Confirm source branch:
    bash
    git fetch kingkongshot
    git diff --stat main..kingkongshot/<source-branch>
  3. Classify changed files as: needs translation, direct sync, deletion, binary/config.
  4. If the worktree has unrelated local changes, report them before switching branches.
2. Create sync branch
  1. Start from latest main:
    bash
    git checkout main
    git pull kingkongshot main
    git checkout -b sync/zh-to-main-<date>[-topic]
  2. Merge the source branch to preserve history:
    bash
    git merge kingkongshot/<source-branch> -X theirs --no-edit
  3. If the user explicitly asks to sync only a few files, use targeted checkout:
    bash
    git checkout kingkongshot/<source-branch> -- <file>
  4. Resolve conflicts before translating.
Show full SKILL.md (221 more words)Show less
3. Translate

Rules:

  • Translate all Chinese prose into English.
  • Preserve Markdown structure, frontmatter, code blocks, command syntax, and HTML tags.
  • Preserve intentionally bilingual matching regexes, such as the Exploration Reduction compatibility check.
  • Installation commands in English-branch docs must use git clone -b main, not git clone -b zh.
  • English-branch language-switch links should point back to the Chinese README.
  • Translate Chinese strings in scripts only when they are user-visible on the English branch.

Validation:

bash
rg -n --pcre2 '\p{Han}' README.md SKILL.md .src docs

After translation, results may only include intentionally retained Chinese, such as language-switch links or bilingual regexes.

4. Validate, commit, and open PR
  1. Run checks that exist in the current repository:
    bash
    git diff --check
  2. Commit:
    bash
    git add -A
    git commit -m "translate: sync <source-branch> to main"
  3. Push and create a PR:
    bash
    git push kingkongshot sync/zh-to-main-<date>[-topic]
    gh pr create --repo kingkongshot/Pensieve --base main --head sync/zh-to-main-<date>[-topic]
  4. Unless the user explicitly delegated the full release flow, ask for confirmation before merging the PR.

Failure Fallback

  • Merge conflicts remain: stop, list conflict files, and resolve them directly. Prefer source-branch content, then translate.
  • Chinese remains after translation: inspect each item, translate it, or explain why it is intentionally retained.
  • Push rejected: fetch, rebase the sync branch onto latest kingkongshot/main, then retry.
  • GitHub CLI authentication fails: report the exact authentication error; do not switch to an unknown remote.

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

Files

SKILL.md and 1 other file in .codex/skills/pensieve-sync-to-main of kingkongshot/Pensieve.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 8731f61

Compare with similar skills

Pensieve Sync To Main 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.

Pensieve Sync To Main compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pensieve Sync To Main this skillkingkongshot/Pensieve2.5k—~1.1kAutomated safety check: PassMIT
Chatbox i18n Translatorchatboxai/chatbox42k—~508Automated safety check: PassGPL-3.0
Internationalization Workflow with i18niOfficeAI/AionUi33k1 repos~1.9kAutomated safety check: PassApache-2.0
Enforce Rules For I18nmoeru-ai/airi50k—~1.5kAutomated safety check: PassMIT
Claude Desktop Chinese Localizationjavaht/claude-desktop-zh-cn7.5k—~1.6kAutomated safety check: PassMIT
Translation ReviewDevolutions/UniGetUI26k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Chatbox i18n Translator

    chatboxai/chatbox

    Translates new or changed i18n keys from a Chatbox Pro diff, staged changes or a commit range, writing the locale JSON files directly with a built-in glossary.

    42k GitHub stars~508 tokensUpdated 17 days ago
    Frontend & DesignAuto-check passed
  • Standards for keeping all user-facing text translatable: read the i18n config first, use namespaced keys, reuse shared strings and follow the key naming rules.

    33k GitHub starsUsed in 1 repo~1.9k tokens
    Frontend & DesignAuto-check passed
  • Review pending AIRI translations on Crowdin in a batch, then sync them into the repository.

    50k GitHub stars~1.5k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Claude Desktop Chinese Localization

    javaht/claude-desktop-zh-cn

    Adds missing Simplified and Traditional Chinese translations to the Claude Desktop Chinese patch across three layers, then checks how many mappings actually hit.

    7.5k GitHub stars~1.6k tokensUpdated 6 days ago
    Frontend & DesignAuto-check passed
  • Translation Review

    Devolutions/UniGetUI

    Reviews UniGetUI .json language files for localization quality, detects parity issues, English-equal entries, wrong-script content, and cross-language outliers, then generates a dataset for…

    26k GitHub stars~1.3k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Frontend I18n

    langflow-ai/langflow

    Add, change, or review user-facing text in the Langflow frontend using the i18n system (i18next / react-i18next).

    155k GitHub stars~1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from kingkongshot/Pensieve

  • Pensieve

    kingkongshot/Pensieve

    Project knowledge base and workflow router. An agent skill from kingkongshot/Pensieve.

    2.5k GitHub stars~436 tokensUpdated 5 mo ago
    Auto-check passed

Questions about Pensieve Sync To Main

What does Pensieve Sync To Main do?

Sync Pensieve's Chinese development/release branch into the English main branch. Pensieve Sync To Main is an agent skill from kingkongshot/Pensieve. Sync Pensieve's Chinese development/release branch into the English main branch.

When should I use Pensieve Sync To Main?

Pensieve Sync To Main fits situations like: asks to sync zh; experimental to main; publish the English branch; translate Pensieve README/tool specs/templates/SKILL.md.

How do I install Pensieve Sync To Main in Claude Code?

Run `npx skills add kingkongshot/Pensieve --skill pensieve-sync-to-main -a claude-code`. Or copy the skill folder (.codex/skills/pensieve-sync-to-main in kingkongshot/Pensieve) into .claude/skills/pensieve-sync-to-main in your project. Claude Code loads it when a task matches its description.

How do I install Pensieve Sync To Main in Codex?

Run `npx skills add kingkongshot/Pensieve --skill pensieve-sync-to-main -a codex`. Or copy the skill folder (.codex/skills/pensieve-sync-to-main in kingkongshot/Pensieve) into .agents/skills/pensieve-sync-to-main in your project. Codex loads it when a task matches its description.

Can I use Pensieve Sync To Main 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 kingkongshot/Pensieve --skill pensieve-sync-to-main -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pensieve-sync-to-main, .gemini/skills/pensieve-sync-to-main, .github/skills/pensieve-sync-to-main and .opencode/skills/pensieve-sync-to-main in your project.

What does Pensieve Sync To Main need to run?

Going by SKILL.md and its folder, Pensieve Sync To Main needs the command-line tools its instructions call (git, rg and gh).

Does Pensieve Sync To Main access the network?

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

Is Pensieve Sync To Main 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 Pensieve Sync To Main use?

Pensieve Sync To Main is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pensieve Sync To Main use?

About 1.1k tokens (SKILL.md is roughly 4.6k 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 Pensieve Sync To Main?

Skills that share tags, products or a category with Pensieve Sync To Main: Chatbox i18n Translator (chatboxai/chatbox, 42k stars), Internationalization Workflow with i18n (iOfficeAI/AionUi, 33k stars), Enforce Rules For I18n (moeru-ai/airi, 50k stars) and Claude Desktop Chinese Localization (javaht/claude-desktop-zh-cn, 7.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pensieve Sync To Main?

kingkongshot (a GitHub user) maintains it in kingkongshot/Pensieve, which has 2,512 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on May 8, 2026.

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