sync-skills SKILL.md skillA

sync-skills from madnpc/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add madnpc/skills/sync-skills@git:20260702.eb2c7d7

Pins git:20260702.eb2c7d7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
madnpc/skills
Path
.claude/skills/sync-skills/SKILL.md
Versions recorded
1
Latest version
git:20260702.eb2c7d7, committed Jul 2, 2026
Size
5,987 bytes
Repository stars
3
License
none declared

适用于本仓库(npc404-skills)同步上游技能:运行 scripts/sync-skills.mjs 检测上游变化,逐个研判 diff 是否为有效更新(实质内容变化,还是排版、笔误等噪音),给出本地化建议,处理完成后推进版本记录。Use in the npc404-skills repo whenever the user wants to check or sync upstream skill sources, review upstream diffs, decide whether an upstream change is worth localizing, or advance skill versions with accept — even if they just say "看看上游有没有更新". 中文关键词:同步技能、技能同步、上游更新、检查上游、上游 diff、有效更新、本地化更新、推进版本、sync skills、accept。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Sync Skills(上游技能同步)

把 `scripts/sync-skills.mjs` 的检测结果变成一次有判断的同步:检测上游变化 → 研判每个 diff 是否为有效更新 → 报告并等用户确认 → 本地化或直接推进版本。

脚本本身只做版本比对和 diff 暂存,不判断内容价值;这个技能的核心工作是替用户读 diff、下判断。

## 适用范围

只在 npc404-skills 仓库内使用:先确认仓库根存在 `scripts/sync-skills.mjs`,找不到就说明不在本仓库,告知用户后停止。需要 Node 18+ 和网络访问 GitHub。

写入范围只限仓库内:本地化只改 `skills/<skill>/`(外加 `scripts/sync.config.json`、README 等仓库文件)。`~/.claude/skills/`、`~/.cc-switch/skills/` 等仓库外的安装/分发副本一律不写不删——那些由用户自行更新。同步完成后至多提示一句"分发副本可能滞后",何时更新由用户决定。

用户只想看当前状态(不查上游)时,运行 `node scripts/sync-skills.mjs status` 即可,不要发起 check。

## 流程

### 1. 检测上游

```bash
node scripts/sync-skills.mjs check          # 全部技能
node scripts/sync-skills.mjs check <skill>  # 只查一个
```

逐技能看状态行并分流:

- `✓ 已是最新` —— 无事发生。
- `✗ 查询 commit 失败 403 …限流` —— 脚本已自动尝试 `GITHUB_TOKEN` 和 `gh auth token`,仍限流说明本机没有可用凭据(gh 未登录或未安装)。按报错里给出的重置时间告知用户稍后再试,或请用户 `gh auth login` / 提供 token。有 ✗ 行时该技能上游状态未知,不要当成"已是最新"。
- `∅ 无版本记录` —— 新增技能还没建基线。提示运行 `node scripts/sync-skills.mjs init <skill>`(init 把当前上游 HEAD 记为已同步基线,不产生 diff,之后的变化才会被 check 捕捉)。
- `● <old> → <new>` —— 上游有变化,材料已暂存:`scripts/.skill-sync/diffs/<skill>.diff` 是新旧版本的逐文件 diff,`scripts/.skill-sync/incoming/<skill>/` 是上游最新原文。进入下一步。

### 2. 研判是否有效更新(核心)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add madnpc/skills/sync-skills@sha256:527a4f94c758636f

The line at the top of this page pins the label git:20260702.eb2c7d7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rrjiq2cqzvzqjt6p.svg)](https://markdownregistry.com/a/art_rrjiq2cqzvzqjt6p)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 2, 2026.

versioncommittedcommitsizeaudit
git:20260702.eb2c7d7 latest2026-07-02 eb2c7d7 5,987 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5987 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

madnpc/skills · 3 stars · license none declared · pushed 2026-09-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rrjiq2cqzvzqjt6p
GET https://markdownregistry.com/api/v1/resolve?ref=madnpc/skills/sync-skills
GET https://markdownregistry.com/api/v1/blob/527a4f94c758636f960e9b0a1859f7dd10d71dbf716b4b297f107eeb31eced96

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from madnpc/skills

AGENTS.md AGENTS.md file
madnpc/skills · AGENTS.md
git:20260713.b7ab5e6 · audit A · 3 stars
CLAUDE.md CLAUDE.md file
madnpc/skills · CLAUDE.md
git:20260702.7a40591 · audit A · 3 stars
brainstorming SKILL.md skill
madnpc/skills · skills/brainstorming/SKILL.md · 适用于编写代码前,当需求或方向仍不清楚时,梳理模糊想法、比较方案并形成轻量设计文档。Use before implementation when the request is ambiguous or the direction is…
git:20260929.4fdade6 · audit A · 3 stars
codebase-design SKILL.md skill
madnpc/skills · skills/codebase-design/SKILL.md · 适用于设计或优化模块接口、决定 seam、提升模块深度与可测试性。Use when designing or improving module interfaces, deciding where a seam belongs…
git:20260624.2d5338c · audit A · 3 stars
diagnosing-bugs SKILL.md skill
madnpc/skills · skills/diagnosing-bugs/SKILL.md · 适用于根因不明确、反复出现、不稳定、跨组件或性能退化的故障。Use when a bug, test failure, runtime error, unexpected behavior, or performance…
git:20260905.d7ecf7d · audit A · 3 stars
domain-modeling SKILL.md skill
madnpc/skills · skills/domain-modeling/SKILL.md · 适用于构建或完善项目领域模型、统一代码库术语、创建或编辑 CONTEXT.md,以及记录或更新 ADR。Build and sharpen a project's domain model. Use when discussing…
git:20260905.d7ecf7d · audit A · 3 stars
grill-me SKILL.md skill
madnpc/skills · skills/grill-me/SKILL.md · 仅在用户明确调用 `$grill-me`、`/grill-me`,或明确要求“拷问我”“追问到底”时,启动一次按决策前沿分轮推进的高强度访谈,以澄清并压力测试计划、设计、决策或想法。Explicit-entry wrapper for a…
git:20260905.d7ecf7d · audit A · 3 stars
grill-with-docs SKILL.md skill
madnpc/skills · skills/grill-with-docs/SKILL.md · 仅在用户明确调用 `$grill-with-docs`、`/grill-with-docs`,或明确要求在高强度访谈中同步沉淀术语表和 ADR 时使用。Explicit-entry wrapper for a relentless…
git:20260929.4fdade6 · audit A · 3 stars
grilling SKILL.md skill
madnpc/skills · skills/grilling/SKILL.md · 适用于用户想对计划、设计、决策或想法进行高强度压力测试,或明确要求 grill、拷问、追问到底、深挖问题时。Relentlessly interview the user about a plan, design, decision…
git:20260905.d7ecf7d · audit A · 3 stars
handoff SKILL.md skill
madnpc/skills · skills/handoff/SKILL.md · 适用于将未完成任务及其上下文移交给新的代理或会话。Use when handing an unfinished task or its context to a fresh agent or a new session…
git:20260713.b7ab5e6 · audit A · 3 stars
karpathy-guidelines SKILL.md skill
madnpc/skills · skills/karpathy-guidelines/SKILL.md · 适用于代码改动容易过度设计、范围蔓延或需要严格审查时。Use when a code change risks overengineering, scope creep, broad refactors, or needs a…
git:20260624.2d5338c · audit A · 3 stars
planning-with-files-zh SKILL.md skill
madnpc/skills · skills/planning-with-files-zh/SKILL.md · 适用于需要跨会话持久追踪的复杂任务、研究或多阶段实施。自动恢复只读取项目规划文件;仅在用户明确要求时,session-catchup.py 才检查同项目会话元数据或输出受限且由 nonce 框定的不可信摘录。Use when work…
v3.21.0-npc404.1 · audit A · 3 stars

Every file in madnpc/skills

Other files named sync-skills

sync-skills SKILL.md skill
sfc-gh-eraigosa/dotfiles · ai/skills/sync-skills/SKILL.md · Synchronize AI agent skills and build binaries from the dotfiles repository.
git:20260707.3f46d49 · audit A · 50 stars
sync-skills SKILL.md skill
foyzulkarim/skills · dev-pipeline/skills/sync-skills/SKILL.md · Copy this repo's skills into another agent harness's skills directory by name — resolves the harness alias to its path…
git:20260823.71acb2d · audit A · 43 stars
sync-skills SKILL.md skill
qa-aman/claude-skills · .claude/skills/sync-skills/SKILL.md · Fetch skills from projects on the current system, genericize them, and add to the claude-skills repository. Use when…
git:20260303.4fa499f · audit A · 21 stars

Browse by kind, by grade A, or by owner.