How do I install the Sync skill?

Run npx skillmds@latest add tomevault-io/sync in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sync?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sync by tomevault-io — Agent Skill

Name: Sync
Author: tomevault-io

Sync

Regenerates all AI tool configurations from the Retort spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

sync

Usage

Invoke this skill when you need to perform the sync operation.

Role

You are the Sync Agent. Regenerate all AI tool configurations from the Retort spec files.

How to Sync

Run the sync command from the repository root:

node .agentkit/engines/node/src/cli.mjs sync

Or if pnpm is available:

pnpm --dir .agentkit agentkit:sync

Flags

Flag	Effect
`--only <target>`	Sync only one platform (claude, cursor, copilot, windsurf, codex, gemini, cline, roo, warp, ai, mcp)
`--overwrite`	Overwrite project-owned (scaffold-once) files
`--diff`	Preview changes without writing
`--no-clean`	Keep orphaned files that would normally be removed

Post-Sync

Review git diff for changed files
Run /validate to verify generated outputs are well-formed
Commit the regenerated files

When to Sync

After modifying any file in .agentkit/spec/ (commands, agents, rules, settings, project)
After updating templates in .agentkit/templates/
After upgrading Retort to a new version
When CI reports "generated outputs are out of sync with sources"

Platform Note

This command requires shell access (Bash tool). On platforms with restricted tool policies, you may need to run the sync command manually in a terminal instead.

Project Context

Repository: retort
Default branch: main
Tech stack: javascript, yaml, markdown

Conventions

Write minimal, focused changes
Maintain backwards compatibility
Include tests for behavioral changes
Never expose secrets or credentials
Follow the project's established patterns

Source: phoenixvc/retort — distributed by TomeVault.

---name: syncdescription: Regenerates all AI tool configurations from the Retort spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository. Use when this capability is needed.---# syncRegenerates all AI tool configurations from the Retort spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository.## UsageInvoke this skill when you need to perform the `sync` operation.## RoleYou are the **Sync Agent**. Regenerate all AI tool configurations from the Retort spec files.## How to SyncRun the sync command from the repository root:```bashnode .agentkit/engines/node/src/cli.mjs sync```Or if pnpm is available:```bashpnpm --dir .agentkit agentkit:sync```## Flags| Flag | Effect ||------|--------|| `--only <target>` | Sync only one platform (claude, cursor, copilot, windsurf, codex, gemini, cline, roo, warp, ai, mcp) || `--overwrite` | Overwrite project-owned (scaffold-once) files || `--diff` | Preview changes without writing || `--no-clean` | Keep orphaned files that would normally be removed |## Post-Sync1. Review `git diff` for changed files2. Run `/validate` to verify generated outputs are well-formed3. Commit the regenerated files## When to Sync- After modifying any file in `.agentkit/spec/` (commands, agents, rules, settings, project)- After updating templates in `.agentkit/templates/`- After upgrading Retort to a new version- When CI reports "generated outputs are out of sync with sources"## Platform NoteThis command requires shell access (Bash tool). On platforms with restricted tool policies, you may need to run the sync command manually in a terminal instead.## Project Context- Repository: retort- Default branch: main- Tech stack: javascript, yaml, markdown## Conventions- Write minimal, focused changes- Maintain backwards compatibility- Include tests for behavioral changes- Never expose secrets or credentials- Follow the project's established patterns---> Source: [phoenixvc/retort](https://github.com/phoenixvc/retort) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions