Agent skill

Design Audit

by UniClipboard in UniClipboard/UniClipboard

定期审计代码库的工程设计问题(高心智复杂度、单一真相源被破坏、catch-all 胖接口、死代码、散落魔法字面量、泄漏抽象、资源生命周期靠环形缓冲)与可优化点,范围限定为自上次审计以来的 git churn,每条发现都落到 file:line 并对照本项目自己的 VISION.md / 各级 AGENTS.md / memory…

AGPL-3.0Auto-check passedMedia & Creative

Install Design Audit

skills CLI
$ npx skills add UniClipboard/UniClipboard --skill design-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install UniClipboard/UniClipboard design-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/UniClipboard/UniClipboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/design-audit .claude/skills/design-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
design-audit
GitHub stars
1.9k
Token cost
~554 tokens
SKILL.md length
139 words
Files
2
Skills in repo
24
Repo updated
First seen
Licence
AGPL-3.0

At a glance

定期审计代码库的工程设计问题(高心智复杂度、单一真相源被破坏、catch-all 胖接口、死代码、散落魔法字面量、泄漏抽象、资源生命周期靠环形缓冲)与可优化点,范围限定为自上次审计以来的 git churn,每条发现都落到 file:line 并对照本项目自己的 VISION.md / 各级 AGENTS.md / memory…

  • Works in 5 steps: 读台账,定基线 → 算 churn,定范围(核心:近期改动优先) → 先理解,再批判(不可跳过) → …
  • 用户要做设计审计 / 每周设计复盘 / 技术债扫描,或运行 $design-audit;不用于行级 bug review(用 $review-strict)或写功能
  • SKILL.md covers 何时触发, 工作流(按序执行) and 铁律(来自有效的那次)
  • Calls git

What it does

Design Audit is an agent skill from UniClipboard/UniClipboard. 定期审计代码库的工程设计问题(高心智复杂度、单一真相源被破坏、catch-all 胖接口、死代码、散落魔法字面量、泄漏抽象、资源生命周期靠环形缓冲)与可优化点,范围限定为自上次审计以来的 git churn,每条发现都落到 file:line 并对照本项目自己的 VISION.md / 各级 AGENTS.md / memory 规则,明确区分「意外复杂度」(要修)与「本质复杂度」(不动)。维护去重台账,重复运行只报新增。Use when 用户要做设计审计 / 每周设计复盘 / 技术债扫描,或运行 $design-audit;不用于行级 bug review(用 $review-strict)或写功能。

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `REFERENCE.md`).

It sits in Media & Creative, covering Design review and critique. It works with Git. The repository describes itself as: Real-time clipboard sync across all your devices — local-first, peer-to-peer, and end-to-end encrypted. No account. No cloud dependency. No central server. The licence is AGPL-3.0.

When your agent uses it

  • 用户要做设计审计 / 每周设计复盘 / 技术债扫描,或运行 $design-audit;不用于行级 bug review(用 $review-strict)或写功能
  • Tasks that involve Design review and critique

Example prompts

  • “/design-audit”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 读台账,定基线
  2. 算 churn,定范围(核心:近期改动优先)
  3. 先理解,再批判(不可跳过)
  4. 多 agent workflow 审计 + 对抗核实
  5. 落盘报告 + 更新台账

What it can do on your machine

Read from SKILL.md and the folder at commit 19fc8bc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Design Audit loads about 554 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 139 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~554

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from UniClipboard/UniClipboard at commit 19fc8bc, republished under its AGPL-3.0 licence (© UniClipboard). 139 words, ~554 tokens.

Download SKILL.mdSave it as .claude/skills/design-audit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
design-audit
description
定期审计代码库的工程设计问题(高心智复杂度、单一真相源被破坏、catch-all 胖接口、死代码、散落魔法字面量、泄漏抽象、资源生命周期靠环形缓冲)与可优化点,范围限定为自上次审计以来的 git churn,每条发现都落到 file:line 并对照本项目自己的 VISION.md / 各级 AGENTS.md / memory 规则,明确区分「意外复杂度」(要修)与「本质复杂度」(不动)。维护去重台账,重复运行只报新增。Use when 用户要做设计审计 / 每周设计复盘 / 技术债扫描,或运行 $design-audit;不用于行级 bug review(用 $review-strict)或写功能。

design-audit

每周一次的工程设计体检。复刻一套被验证有效的方法:先理解,再批判;用「读起来难不难懂」当心智复杂度信号;每个结论落到真实代码;对照项目自己的规矩;只骂意外复杂度。

详细的审计镜头、严重度定义、台账与报告格式、workflow 脚本骨架见 REFERENCE.md。

何时触发

  • 用户运行 $design-audit,或说"设计审计 / 每周复盘 / 技术债扫描 / 有哪些可优化的地方"
  • 不是 行级 bug review(那是 $review-strict),不是 写功能

工作流(按序执行)

1. 读台账,定基线
  • 读 .planning$design-audit/ledger.md。取 last_audited_commit(无则用 4 周前或 main~200)。
  • 记下所有 accepted / wontfix 的 finding ID——本轮 不再报 这些。
2. 算 churn,定范围(核心:近期改动优先)
bash
git log --oneline <last_audited_commit>..HEAD | head -50
git diff --stat <last_audited_commit>..HEAD
  • 取改动文件,按 crate/子系统分组成 审计目标(每组 ≤ ~8 文件)。
  • 叠加 crates/AGENTS.md 的 COMPLEXITY HOTSPOTS:churn 命中热点的目标优先级拉高。
  • churn 为空 → 报告"无新改动"并退出。
3. 先理解,再批判(不可跳过)
  • 对每个目标,先 读关键文件 建立局部地图,再判断。没有地图的批判是瞎猜。
  • 准备好规矩参照系:VISION.md、相关 crate 的 AGENTS.md、crates/uc-core/AGENTS.md §5.4、 memory 目录的规则(如 [[no-timing-coupled-coordination]]、[[minimize-crate-api-surface]])。
4. 多 agent workflow 审计 + 对抗核实
  • 调 Workflow(脚本骨架见 REFERENCE.md「Workflow skeleton」):
    • Audit 阶段:每个目标一个 agent,按 REFERENCE.md 的 7 个镜头审,每条 finding 必须带 file:line + 一段引用代码证据。
    • Verify 阶段:对每条 finding 派对抗 agent 核实——是真的吗?是 意外 复杂度还是 本质 复杂度?违反了哪条项目规矩?默认怀疑,证据不足就降级/丢弃。
    • Synthesize 阶段:传入台账已知 ID 去重,按严重度排序,产出报告。
5. 落盘报告 + 更新台账
  • 写 .planning$design-audit/YYYY-Www.md(报告格式见 REFERENCE.md)。
  • 更新 .planning$design-audit/ledger.md:新 finding 追加为 open;记录本轮 last_audited_commit = HEAD。
  • 不提交、不开 PR(除非用户要)。最后在对话里给 P1/P2 的精简清单 + 推荐先动哪一条。

铁律(来自有效的那次)

  • 落到代码:没有 file:line + 代码证据的 finding 一律不写。宁可少报,不可臆测。
  • 意外 vs 本质:本质复杂度(问题本身就难,如剪贴板回环、分布式最终一致)不报 或只标注,只报实现引入的意外复杂度。
  • 对照自家规矩:"违反你自己立的规矩"(VISION/AGENTS/memory)比"违反通用原则"更该优先。
  • 去重:台账里 accepted/wontfix 的不再报;同一 finding 跨周用稳定 ID 映射。
  • 可执行:每条 P1/P2 给出可切片的修法草图(S0/S1… 风格),不是空泛的"建议重构"。

© UniClipboard, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/design-audit of UniClipboard/UniClipboard.

  • SKILL.md
  • REFERENCE.md

Open the folder on GitHubat commit 19fc8bc

Compare with similar skills

Design Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Design Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design Audit this skillUniClipboard/UniClipboard1.9k—~554Automated safety check: PassAGPL-3.0
Personal Assistant Reviewedonyzpc/personal-assistant148—~3.2kAutomated safety check: PassAGPL-3.0
Design ReviewPrismer-AI/PrismerCloud1.6k—~1.3kAutomated safety check: NotesMIT
Kicad Reviewmixelpixx/Konnect917—~3.2kAutomated safety check: PassAGPL-3.0
Architecture Design Reviewbbartling/open-fdd173—~1.3kAutomated safety check: PassCustom licence
UI Design Reviewjayminwest/warren479—~1.9kAutomated safety check: PassMIT

Similar skills

  • Personal Assistant Review

    edonyzpc/personal-assistant

    Review uncommitted or PR diffs in the personal-assistant Obsidian plugin with project-specific risk lanes, second-layer future-risk checks, severity discipline, subagent review routing, and…

    148 GitHub stars~3.2k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Design Review

    Prismer-AI/PrismerCloud

    Five-dimension design audit (frontend UI/UX · server data-model & flow · endpoint spec · daemon-runtime/SDK & local-cache-first · built-in skill/agent-role), executed by a NON-implementing agent.

    1.6k GitHub stars~1.3k tokensUpdated 9 days ago
    Media & CreativeAuto-check: notes
  • Kicad Review

    mixelpixx/Konnect

    Design review and validation workflow for KiCAD projects via MCP tools.

    917 GitHub stars~3.2k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Architecture Design Review

    bbartling/open-fdd

    A skill your agent uses to evaluate architecture, design proposals, refactors, module boundaries, dependency direction, data flow, concurrency model, and maintainability tradeoffs across any codebase.

    173 GitHub stars~1.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • UI Design Review

    jayminwest/warren

    Independent design review of a warren web-UI change. An agent skill from jayminwest/warren.

    479 GitHub stars~1.9k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Kicad Design Review

    oaslananka/kicad-mcp-pro

    Comprehensive KiCad design review skill covering schematic, PCB, DFM, manufacturing, high-speed, and simulation review workflows.

    120 GitHub stars~529 tokensUpdated today
    Media & CreativeAuto-check passed

More from UniClipboard/UniClipboard

All 24 skills in this repo
  • Beui

    UniClipboard/UniClipboard

    Pick and install beUI (@beui) animated React components from the shadcn registry.

    1.9k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Create PR

    UniClipboard/UniClipboard

    Push the current branch and open a GitHub pull request against main.

    1.9k GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Dual Side Debug

    UniClipboard/UniClipboard

    Inspect uniclipboard logs from BOTH the macOS host and the mounted Windows peer when debugging cross-platform sync, pairing, transfer, or daemon issues.

    1.9k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • E2E Test Thinker

    UniClipboard/UniClipboard

    Analyze the current branch's diff against main and determine which changes are testable via CLI-based end-to-end tests.

    1.9k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • iOS Log Diagnose

    UniClipboard/UniClipboard

    Drive the UniClipboard iOS app in a simulator and read its OSLog yourself to diagnose a mobile-sync bug, instead of asking the user to paste logs.

    1.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Learn

    UniClipboard/UniClipboard

    Record a lesson learned into crates/AGENTS.md (CONVENTIONS or ANTI-PATTERNS section).

    1.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Works with

Questions about Design Audit

What does Design Audit do?

定期审计代码库的工程设计问题(高心智复杂度、单一真相源被破坏、catch-all 胖接口、死代码、散落魔法字面量、泄漏抽象、资源生命周期靠环形缓冲)与可优化点,范围限定为自上次审计以来的 git churn,每条发现都落到 file:line 并对照本项目自己的 VISION.md / 各级 AGENTS.md / memory…. Design Audit is an agent skill from UniClipboard/UniClipboard.

When should I use Design Audit?

Design Audit fits situations like: 用户要做设计审计 / 每周设计复盘 / 技术债扫描,或运行 $design-audit;不用于行级 bug review(用 $review-strict)或写功能; tasks that involve Design review and critique.

How do I install Design Audit in Claude Code?

Run `npx skills add UniClipboard/UniClipboard --skill design-audit -a claude-code`. Or copy the skill folder (.agents/skills/design-audit in UniClipboard/UniClipboard) into .claude/skills/design-audit in your project. Claude Code loads it when a task matches its description.

How do I install Design Audit in Codex?

Run `npx skills add UniClipboard/UniClipboard --skill design-audit -a codex`. Or copy the skill folder (.agents/skills/design-audit in UniClipboard/UniClipboard) into .agents/skills/design-audit in your project. Codex loads it when a task matches its description.

Can I use Design Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add UniClipboard/UniClipboard --skill design-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-audit, .gemini/skills/design-audit, .github/skills/design-audit and .opencode/skills/design-audit in your project.

What does Design Audit need to run?

Going by SKILL.md and its folder, Design Audit needs the command-line tools its instructions call (git).

Does Design Audit access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Design Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Design Audit use?

Design Audit is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Design Audit use?

About 554 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Design Audit?

Skills that share tags, products or a category with Design Audit: Personal Assistant Review (edonyzpc/personal-assistant, 148 stars), Design Review (Prismer-AI/PrismerCloud, 1.6k stars), Kicad Review (mixelpixx/Konnect, 917 stars) and Architecture Design Review (bbartling/open-fdd, 173 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design Audit?

UniClipboard (a GitHub organization) maintains it in UniClipboard/UniClipboard, which has 1,860 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 9, 2026.

Source: UniClipboard/UniClipboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.