Agent skill

Sync Pstack

by udecode in udecode/dotai

Set up the pstack plugin in a project through an interview, and keep every pstack project on one pinned tag and one shared AGENTS.md overrides block.

No licenceAuto-check passedAgent Workflows

Install Sync Pstack

skills CLI
$ npx skills add udecode/dotai --skill sync-pstack -a claude-code

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

GitHub CLI
$ gh skill install udecode/dotai sync-pstack --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/dotai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sync-pstack .claude/skills/sync-pstack && 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
sync-pstack
GitHub stars
1.2k
Token cost
~8.4k tokens
SKILL.md length
5,303 words
Files
20 (incl. scripts, references, assets)
Skills in repo
4
Repo updated
First seen
Licence
None found

At a glance

Set up the pstack plugin in a project through an interview, and keep every pstack project on one pinned tag and one shared AGENTS.md overrides block.

  • Works in 7 steps: Discover. Run discover , then read… → Interview. This is the first step the… → Record the answers in… → …
  • Install pstack in a repo
  • SKILL.md covers Layers, Run the script, Choose the mode and Setup, plus 9 more sections
  • Runs JavaScript scripts from its folder; calls git, node and npx

What it does

Sync Pstack is an agent skill from udecode/dotai. Set up the pstack plugin in a project through an interview, and keep every pstack project on one pinned tag and one shared AGENTS.md overrides block. Use to set up or install pstack in a repo, sync, bump or update pstack everywhere, list which projects use pstack or have drifted, compare setups, audit a project's skills for drift from pstack (which to cut, fold or keep), change which work runs a panel, architect or an arena without asking ("from now on X runs architect"), or move a workflow lesson, including a…

Its SKILL.md is about 8.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 23 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `assets/block.md` and `references/adapt.md`).

It sits in Agent Workflows, covering Agent instruction files.

When your agent uses it

  • Install pstack in a repo
  • Update pstack everywhere
  • List which projects use pstack
  • Audit a projects skills for drift from pstack (which to cut

Example prompts

  • “from now on X runs architect”
  • “/sync-pstack”

Requirements

  • Node.js

Workflow steps

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

  1. Discover. Run discover , then read AGENTS.md and the workflow rules it routes through, in full. Nothing is written yet.
  2. Interview. This is the first step the user sees. Follow the interview: prepare from evidence, always ask about delivery, recommend the…
  3. Record the answers in .agents/pstack.json, with tag from latest.
  4. Adapt the project per adapt. Remove vendored pstack copies, settle orphaned skills and rule forks, keep the formatter off the synced…
  5. Apply. Run apply --dry-run, read the diff, then run apply .
  6. Verify.
  7. Deliver by the project's delivery answer. When it commits, the commit body names which runtimes and which of the project's committers gain…

What it can do on your machine

Read from SKILL.md and the folder at commit 6eb4bd9. 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

    Ships 1 file in scripts/ (JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • node
    • npx
    • 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, npx 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

Sync Pstack loads about 8.4k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 160 tokens; SKILL.md has 5,303 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~160
When it runs · the whole SKILL.md, loaded when a task matches
~8.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 5,303 words (~8,447 tokens).

“One skill sets pstack up in a project and keeps every set-up project in step with upstream pstack and with one shared set of overrides. Project-only rules never sync.”

— opening of SKILL.md by udecode
name
sync-pstack
metadata.source
udecode/dotai
metadata.source-path
skills/sync-pstack

Read the full SKILL.md on GitHub

Files

SKILL.md and 19 other files (scripts, references, assets) in skills/sync-pstack of udecode/dotai.

  • SKILL.md
  • agents/openai.yaml
  • assets/block.md
  • assets/pstack/cross.mjs
  • assets/pstack/decisions-check.mjs
  • assets/pstack/freeze.mjs
  • assets/pstack/mutate.mjs
  • assets/pstack/plan-open.mjs
  • assets/pstack/plan-page.mjs
  • assets/pstack/proof.mjs
  • assets/pstack/reply.mjs
  • assets/pstack/reread.mjs
  • assets/pstack/status.mjs
  • references/adapt.md
  • references/audit-brief.md
  • references/interview.md
  • scripts
  • … and 3 more

Open the folder on GitHubat commit 6eb4bd9

Compare with similar skills

Sync Pstack 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.

Sync Pstack compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sync Pstack this skilludecode/dotai1.2k—~8.4kAutomated safety check: PassNone
Using Agent Skillsaddyosmani/agent-skills102k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.7k2 repos~627Automated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0
Writing For Agentsbestofjs/bestofjs3.1k17 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    102k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed
  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.7k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed
  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed
  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 17 repos~2.7k tokens
    Agent WorkflowsAuto-check passed
  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from udecode/dotai

  • Walkthrough

    udecode/dotai

    Present final screenshots or rendered artifacts as an annotated walkthrough when visual evidence is requested.

    1.2k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Plan Page

    udecode/dotai

    Write, check, repair and publish a plan page: a project's plans and subject files under its plans directory, rendered by .agents/pstack/plan-page.mjs and rendered as one local HTML page per subject…

    1.2k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Test Audit

    udecode/dotai

    Audit existing tests for low-value, duplicated or implementation-coupled cases and the test-only code they keep alive, then remove or rewrite them on evidence.

    1.2k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Sync Pstack

What does Sync Pstack do?

Set up the pstack plugin in a project through an interview, and keep every pstack project on one pinned tag and one shared AGENTS.md overrides block. Sync Pstack is an agent skill from udecode/dotai.md overrides block.

When should I use Sync Pstack?

Sync Pstack fits situations like: install pstack in a repo; update pstack everywhere; list which projects use pstack; audit a projects skills for drift from pstack (which to cut.

How do I install Sync Pstack in Claude Code?

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

How do I install Sync Pstack in Codex?

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

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

What does Sync Pstack need to run?

Going by SKILL.md and its folder, Sync Pstack needs JavaScript for the scripts in its folder and the command-line tools its instructions call (git, node, npx and gh). Our summary lists: Node.js.

Does Sync Pstack access the network?

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

Is Sync Pstack 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Sync Pstack use?

No licence was found for Sync Pstack or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Sync Pstack use?

About 8.4k tokens (SKILL.md is roughly 34k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.8k tokens, read only when the agent opens those files.

What are the alternatives to Sync Pstack?

Skills that share tags, products or a category with Sync Pstack: Using Agent Skills (addyosmani/agent-skills, 102k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.7k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars) and Task Observer (rebelytics/one-skill-to-rule-them-all, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sync Pstack?

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

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