sync

sync is a skill for Claude Code from anton-abyzov/specweave. It costs 0 tokens per session (758 once invoked), scanned A, original, MIT.

A command-line tool for keeping local project progress and work items aligned with GitHub, Jira, and Azure DevOps. It can send updates, bring in issues, check connection health, and set up a provider.

In plain words
What is it for?
Use it to push progress to a tracker, import external issues into local work items, inspect sync problems, or configure a tracker connection.
Why use it?
It removes the need to update several issue trackers separately and helps avoid duplicate or missing links between local work and external issues.

Skill for Claude Code

Written for Claude Code: argument-hint in frontmatter.

Part of the sw plugin — 10 skills, 1 agent, 4 hooks shipped together

Good fit Use it to push progress to a tracker, import external issues into local work items, inspect sync problems, or configure a tracker connection.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/anton-abyzov/specweave/sync
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.

Any agent
npx skills add anton-abyzov/specweave --skill sync
Clone the repo
git clone --depth 1 https://github.com/anton-abyzov/specweave

Made for: Claude Code.

Or install sw, the plugin that ships this one along with the rest of its 10 skills, 1 agent, 4 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for sync

README.md
[![agentmods](https://agentmods.dev/badge/skills/anton-abyzov/specweave/sync.svg)](https://agentmods.dev/skills/anton-abyzov/specweave/sync)
Your own site
<a href="https://agentmods.dev/skills/anton-abyzov/specweave/sync"><img src="https://agentmods.dev/badge/skills/anton-abyzov/specweave/sync.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 758 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00000 $0.00758
Opus 5 $0.00000 $0.00379
Sonnet 5 $0.00000 $0.00152
Haiku 4.5 $0.00000 $0.00076

Measured 3d ago against content hash fc5b06b02351, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

sync scanned grade A with 1 finding 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

Everything goes through the CLI. Never call `gh`, `curl`, or a provider REST API
plugins/specweave/skills/sync/SKILL.md · 64 lines

How it starts

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

sw:sync — external tracker sync

Everything goes through the CLI. Never call gh, curl, or a provider REST API directly: the CLI owns token resolution, the rate budget, duplicate detection and the bidirectional links.

Commands

Intent Command
Push local progress to issues specweave sync push [increment-id]
Preview a push specweave sync push <id> --dry-run
Push to one provider specweave sync push <id> --provider github
Fix stale/duplicate milestones first specweave sync push <id> --reconcile
Report external changes specweave sync pull [--since 7]
Import issues as increments specweave sync pull --create-increments
Tokens, health, retry queue, gaps specweave sync status [--json]
Connect a provider specweave sync setup [--provider github]
Validate an existing config specweave sync setup --validate

sync push runs tasks.md → spec.md ACs → living docs → provider write, then drains the retry queue through the same entry point. Exit code of sync status is 1 when anything needs attention; --json prints one parsable report (providers, github, health, resilience, gaps, hasIssues).

Not sync: specweave doctor --fix-status repairs metadata.json ↔ spec.md status desyncs, and specweave sync-living-docs regenerates internal living docs.

Providers

Read the provider from .specweave/config.json (sync.github / sync.profiles); never guess. GitHub is the first-class path. Jira and Azure DevOps are community-maintained: push and close work, nothing else is guaranteed — say so before promising Jira/ADO behaviour.

Tokens resolve in one documented order: .specweave/config.jsonprocess.env (GITHUB_TOKEN, then GH_TOKEN) → project .envgh auth token. sync status prints which layer and which account won. A 404 on write means the token's account has no write access to owner/repo — fix the token, do not retry.

Concept mapping tables: plugins/specweave/reference/{github,jira,ado}/*-specweave-mapping.md.

Read the full file on GitHub · 64 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 · 64 lines · 0 tokens per session scan A fc5b06b02351

Subscribe to this mod's changes

sync is a skill published in the GitHub repository anton-abyzov/specweave (159 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 758 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.