sync-docs

A documentation-sync guide for keeping Elixir SDK guides aligned with the official Claude Agent SDK documentation. It compares mirrored pages and updates examples using Elixir code.

In plain words
What is it for?
Use it to compare guides in docs/guides/ with official SDK pages, find missing or changed content, and update the Elixir equivalents. It also helps mark unfinished sections and keep guide titles concise.
Why use it?
It helps prevent guides from becoming outdated when the official documentation changes. It also keeps the guides consistent with the project's Elixir and OTP conventions.

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/guess/claude_code/sync-docs
Any agent
npx skills add guess/claude_code --skill sync-docs
Clone the repo
git clone --depth 1 https://github.com/guess/claude_code

Made for: Claude Code, Codex.

Per session 60 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,422 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.00060 $0.02422
Opus 5 $0.00030 $0.01211
Sonnet 5 $0.00012 $0.00484
Haiku 4.5 $0.00006 $0.00242

Measured 2d ago against content hash 472c9141120e, 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 2d 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.

.claude/skills/sync-docs/SKILL.md · 225 lines

How it starts

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

Sync Documentation Guides

Synchronize the Elixir SDK documentation guides in docs/guides/ with the official Claude Agent SDK documentation.

Overview

Each guide in docs/guides/ mirrors an official Agent SDK documentation page. The guides show Elixir SDK equivalents of the official examples — never Python or TypeScript. This skill provides a systematic workflow to detect content drift and update guides when the official docs change.

Guide Conventions

All guides follow rules defined in docs/guides/CLAUDE.md. Key rules:

  • Use full module names in prose (e.g., ClaudeCode.Stream.final_result/1)
  • Use ClaudeCode.query/2 for one-off examples; reserve ClaudeCode.start_link/1 + ClaudeCode.stream/3 for streaming/multi-turn
  • Pattern match directly in fn clauses
  • Follow official structure closely but prioritize idiomatic Elixir/OTP
  • Include Elixir-only guidance where it applies
  • Mark incomplete sections with callouts

Guide titles must be concise (1-3 words) for sidebar navigation. Prefer "File Checkpointing" over "Rewind file changes with checkpointing". Do NOT adopt verbose titles from the official docs — keep titles short even if the official page uses a longer name.

Each guide starts with:

# Concise Title

Subtitle describing the guide.

> **Official Documentation:** This guide is based on the [official Claude Agent SDK documentation](https://platform.claude.com/docs/en/agent-sdk/PAGE). Examples are adapted for Elixir.

Guide Inventory

Each guide maps to an official page at https://platform.claude.com/docs/en/agent-sdk/{slug}:

Guide File Official Slug
cost-tracking.md cost-tracking
custom-tools.md custom-tools
file-checkpointing.md file-checkpointing
hooks.md hooks
hosting.md hosting
mcp.md mcp
modifying-system-prompts.md modifying-system-prompts
permissions.md permissions
plugins.md plugins
secure-deployment.md secure-deployment
sessions.md sessions
skills.md skills
slash-commands.md slash-commands
stop-reasons.md stop-reasons
streaming-output.md streaming-output
streaming-vs-single-mode.md streaming-vs-single-mode
structured-outputs.md structured-outputs
subagents.md subagents
user-input.md user-input

Read the full file on GitHub · 225 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. 2d ago First seen · 225 lines · 60 tokens per session scan A 472c9141120e

Subscribe to this mod's changes

sync-docs is a skill published in the GitHub repository guess/claude_code (96 stars, last pushed 2mo ago), licensed MIT. It adds 60 tokens to every session and 2,422 once invoked, about $0.0003 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

tui-design

This skill should be used when designing terminal user interfaces, creating TUI layouts, choosing TUI color schemes, implementing keyboard navigation, building terminal dashboards, or working with any TUI framework. Activates on mentions of TUI design, terminal UI, Ratatui layout, Ink components, Textual widgets…

pass-agent/loomkin · 109 tokens

modern-css

Specialized knowledge for writing modern high-quality CSS. Trigger this skill when starting a new CSS project/file, when the user asks about new CSS features (e.g. Masonry, View Transitions, Container Queries, Scroll-driven animations), or requests refactoring of legacy styles to modern standards.

pass-agent/loomkin · 61 tokens

vault-meeting

Process a meeting transcript — extract decisions, action items, and key discussion points into structured vault entries.

pass-agent/loomkin · 23 tokens

elixir-expert

Expert in Elixir, Phoenix Framework, and OTP. Specializes in building concurrent, fault-tolerant, and real-time applications using the BEAM. Use when building Elixir applications, working with Phoenix, implementing GenServers, or designing distributed systems on the BEAM.

pass-agent/loomkin · 60 tokens

vault-groom

Audit and clean up knowledge base state — archive completed work, fix inconsistencies.

pass-agent/loomkin · 19 tokens

clack

Build and maintain interactive Node.js/Bun CLIs with Clack (@clack/prompts and @clack/core). Use when an AI agent needs to design prompt flows, implement cancellation-safe input handling, add spinners/log/note UX, apply Clack best practices, or generate runnable examples aligned with official Clack docs.

pass-agent/loomkin · 72 tokens