yd-doc-sync

yd-doc-sync is a skill for Codex from LeeYudok/doksam-skills. It costs 201 tokens per session (3,024 once invoked), scanned A, original, MIT.

A documentation-maintenance workflow that compares project documents with the current code, configuration, files, and command results. It finds and fixes stale references after files, commands, ports, dependencies, or large code structures change.

In plain words
What is it for?
Use it to update READMEs, AGENTS.md, CLAUDE.md, rules, skills, and docs after repository changes.
Why use it?
It removes documentation drift, such as README or agent instructions pointing to deleted or moved paths or obsolete commands.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: mentions CLAUDE.md; mentions AGENTS.md.

Good fit Use it to update READMEs, AGENTS.md, CLAUDE.md, rules, skills, and docs after repository changes.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/leeyudok/doksam-skills/yd-doc-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 LeeYudok/doksam-skills --skill yd-doc-sync
Clone the repo
git clone --depth 1 https://github.com/LeeYudok/doksam-skills

Made for: Codex.

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 yd-doc-sync

README.md
[![agentmods](https://agentmods.dev/badge/skills/leeyudok/doksam-skills/yd-doc-sync/github.svg)](https://agentmods.dev/skills/leeyudok/doksam-skills/yd-doc-sync)
Your own site
<a href="https://agentmods.dev/skills/leeyudok/doksam-skills/yd-doc-sync"><img src="https://agentmods.dev/badge/skills/leeyudok/doksam-skills/yd-doc-sync/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for yd-doc-sync

Your own site · 80×15
<a href="https://agentmods.dev/skills/leeyudok/doksam-skills/yd-doc-sync"><img src="https://agentmods.dev/badge/skills/leeyudok/doksam-skills/yd-doc-sync.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 201 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,024 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. 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.00201 $0.03024
Opus 5.5 $0.00080 $0.01210
Sonnet 5.5 $0.00040 $0.00605
Haiku 4.5 $0.00020 $0.00302

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

Security

Grade A, and why

yd-doc-sync 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 13d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/find_stale_refs.py, tests/test_find_stale_refs.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

skills/yd-doc-sync/SKILL.md · 159 lines

How it starts

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

yd-doc-sync

코드는 빌드와 테스트가 지켜 주지만 문서는 아무도 지켜 주지 않는다. 디렉터리를 지우거나 옮기면 그 경로를 가리키던 지침·README·규칙이 조용히 거짓이 된다. 에이전트는 그 문서를 읽고 없는 파일을 찾거나 지운 명령을 다시 돌린다.

이 스킬은 바뀐 실제에 문서를 맞춘다. 판단 기준은 언제나 코드·설정·파일시스템과 실제 실행 결과다. 문서끼리 맞추는 것이 아니다.

경계

대상 맡는 스킬
에이전트 영속 메모리의 사실 감사 yd-memory-factcheck (이 스킬은 경로 참조만 같이 고친다)
AGENTS.yaml 처음 세팅·구조 변경 yd-agents-yaml (이 스킬은 기존 값이 실제와 맞는지만 본다)
프로젝트 전용 대조표 레포에 *-doc-sync 같은 프로젝트 스킬이 있으면 그 대조표를 먼저 따른다
고친 문장·보고서·이슈/MR 본문의 문장 정리 yd-writer-kr (이 스킬은 무엇을 고칠지 정하고, 문장은 그 규칙으로 쓴다)
이슈·커밋·MR yd-git-ship

워크플로

1. 범위 정하기

무엇이 바뀌었는지부터 확정한다. 추측으로 범위를 넓히지 않는다.

git log --oneline -15                          # 기준점 찾기
git diff --name-status -M <기준> HEAD | head    # 무엇이 지워지고 옮겨졌나
  • 기준점은 사용자가 말한 커밋·MR, 없으면 문서를 마지막으로 맞춘 머지 직전 커밋이다.
  • 레포의 프로젝트 스킬·AGENTS.md·.claude/rules/ 에 문서 갱신 규칙(어떤 코드가 바뀌면 어떤 문서를 고치는지)이 있으면 읽고 그대로 따른다.

2. 드리프트 뽑기 — 스크립트 먼저

손 grep 보다 스크립트가 먼저다. 사람이 짠 정규식은 하위 프로젝트의 같은 이름 경로 (ews-v3/web/src 를 가리키는 web/src)를 지운 경로로 오인한다.

S=<이 스킬>/scripts/find_stale_refs.py
python3 $S --removed-since <기준>            # 지워지거나 옮겨진 경로를 가리키는 줄
python3 $S                                  # 전체 존재 검사(첫 조각이 레포에 있는 경로만)
python3 $S --exclude 'model-source/*' --json  # 보존본 제외, 기계 처리용
  • 추적 중인 문서(*.md·*.yaml·*.toml·AGENTS*·CLAUDE* 등)만 본다. 코드의 경로 문자열은 빌드·테스트 몫이다.

  • 전체 존재 검사는 첫 경로 조각이 지금 레포에 있는 토큰만 본다(다른 레포 경로 소음을 줄이려고). 최상위 폴더를 통째로 지웠다면 반드시 --removed-since 로 잡는다.

  • 레포 어딘가에 실제로 있는 경로(하위 프로젝트 기준 상대경로, docs/12 같은 번호 축약)는 빼고 보고한다. 옮겨진 경로는 renamed -> 새 경로 로 알려 준다.

  • 종료 코드는 current 가 있으면 1, history 만 남으면 0, git·인자 오류는 2 다. 1 은 스크립트가 고장 났다는 뜻이 아니라 고칠 줄이 있다는 뜻이다. --strict 는 history 도 1 로 센다.

  • 스크립트가 못 잡는 드리프트는 따로 확인한다. 서술 종류마다 근거 원천이 정해져 있고, 문서끼리 맞추지 않는다.

    서술 근거 원천
    환경변수 이름 설정을 읽는 코드(os.Getenv·config 로더), .env.example
    포트·컨테이너·헬스체크 Quadlet *.container·compose 의 HealthCmd·PublishPort, 실제 podman ps/docker ps
    실행 명령·CI 잡 package.json scripts, Makefile, CI 설정 파일
    의존성·버전 go.mod·package.json·lock 파일
    개수·수치("테이블 37개") 실제 조회 결과와 그 날짜(DB 쿼리·find·grep -c)
    트래커 동작(자동 클로즈 등) 직전 이슈·MR 의 실제 state

Read the full file on GitHub · 159 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 13d ago Changed · +8 lines fdc207655be9
  2. 14d ago First seen · 151 lines · 201 tokens per session scan A a1a8ddf6c7d7

Subscribe to this mod's changes

yd-doc-sync is a skill published in the GitHub repository LeeYudok/doksam-skills (14 stars, last pushed 7d ago), licensed MIT. It adds 201 tokens to every session and 3,024 once invoked, about $0.0008 per session on Opus 5.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-10-11.

Related

Other skills, from other repositories