sync-docs

A documentation workflow for keeping internal technical notes and public Mintlify documentation in sync. Mintlify is a service for publishing developer documentation.

In plain words
What is it for?
Updating architecture, API, testing, administration, scripts, and public plugin documentation after changes, either manually or after a code push.
Why use it?
It reduces the risk that developers or customers read outdated instructions after code changes. It also separates private implementation details from customer-facing guidance.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/reorder-js/reorder/sync-docs
Any agent
npx skills add reorder-js/reorder --skill sync-docs
Clone the repo
git clone --depth 1 https://github.com/reorder-js/reorder

Made for: Claude Code, Codex.

Per session 39 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 609 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00039 $0.00609
Opus 5 $0.00019 $0.00304
Sonnet 5 $0.00008 $0.00122
Haiku 4.5 $0.00004 $0.00061

Measured 3d ago against content hash 4a9514ac5927, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

sync-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/sync-docs/SKILL.md · 38 lines

How it starts

The opening of the file, as written. The whole thing — 38 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Sync Documentation (Internal Docs & Public Mintlify)

This skill manages the two-stage documentation synchronization workflow:

  1. Internal Technical Docs (reorder/docs/): Source of truth for developers and AI agents (architecture, APIs, testing, admin UX, scripts).
  2. Public Mintlify Docs (../docs/): Customer-facing documentation (MDX format) for merchants and developers using the plugin.

When to trigger

  • Automatically: Whenever you successfully git push code changes to the reorder repository, ALWAYS ask the user: "Czy zmiany wymagają aktualizacji dokumentacji (wewnętrznej w reorder/docs lub publicznej Mintlify w ../docs)? Jeśli tak, użyję skilla sync-docs."
  • Manually: When the user asks to "sync docs", "update documentation", "zaktualizuj docs", or runs /sync-docs.

2-Stage Synchronization Workflow

Stage 1: Verify & Update Internal Technical Docs (reorder/docs/)

Before updating public docs, ensure the internal source of truth is 100% accurate:

  1. Check changed code, workflows, API contracts, domain models, or scripts in reorder.
  2. Update the corresponding documents in reorder/docs/:
    • docs/architecture/ for domain architecture or lifecycle changes
    • docs/api/ for Admin or Store route changes
    • docs/admin/ for UI flow, filter, or widget changes
    • docs/testing/ for new test utilities, scripts, or coverage
    • docs/README.md for index and roadmap updates
  3. If changes were made to reorder/docs/, commit them to the reorder repository (propose Conventional Commit e.g. docs: update internal documentation for <feature>).

Stage 2: Sync to Public Mintlify Repository (../docs/)

Only after internal docs are accurate:

  1. Navigate to ../docs and ensure your local branch is synchronized with remote before making any edits (git pull).
  2. Read ../docs/AGENTS.md to review style guidelines, terminology, and content boundaries (do not expose internal locking/scheduler details).
  3. Update or create corresponding .mdx files in ../docs.
  4. Update ../docs/docs.json navigation structure if new pages were introduced.
  5. Review changes with git status and git diff.
  6. Propose a Conventional Commit message (e.g. docs: update <feature> guide), wait for approval, and push to the docs remote repository (git push).
  7. Report completion to the user.

Read the full file on GitHub · 38 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 38 lines · 39 tokens per session scan A 4a9514ac5927

Subscribe to this mod's changes

sync-docs is a skill published in the GitHub repository reorder-js/reorder (51 stars, last pushed 9d ago), licensed MIT. It adds 39 tokens to every session and 609 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

task-manager

Capture actionable user requests as persistent tasks, update task status as work progresses, and keep a shared task store in sync. Use when a user asks an agent to do work, check progress, block a task, complete a task, or manage the Kanban board.

iamlukethedev/Claw3D · 56 tokens

soundclaw

Control Spotify playback, search music, and return shareable music links.

iamlukethedev/Claw3D · 18 tokens

todo

Maintain a shared workspace TODO list with blocked tasks.

iamlukethedev/Claw3D · 12 tokens

saleor-paper-storefront

Project-specific patterns for the Saleor Paper storefront built with Next.js 16, TypeScript, and Tailwind CSS. Use when working with product pages, checkout flow, caching, variant selection, filtering, SEO, or UI components. For universal Saleor API patterns, see the saleor-storefront dependency.

saleor/storefront · 68 tokens

paper-migrations

Apply chronological Paper storefront upgrades to a forked shop. Use when the user says upgrade Paper, apply Paper migrations, catch up with upstream caching, or paper-version. Reads migrations/manifest.json and paper-version.json; ports architecture without overwriting custom styling.

saleor/storefront · 55 tokens

storefront-best-practices

ALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart, payment flows, product pages, product listings, navigation, homepage, or ANY page/component in a storefront. CRITICAL for adding checkout, implementing cart…

medusajs/medusa-agent-skills · 107 tokens