DESIGN.md@repo-scan/docsA

DESIGN.md@repo-scan/docs from kerberosclaw/kc_ai_skills is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add kerberosclaw/kc_ai_skills/repo-scan/docs/DESIGN.md@git:20260324.12e2b3a

Pins git:20260324.12e2b3a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
kerberosclaw/kc_ai_skills
Path
repo-scan/docs/DESIGN.md
Versions recorded
1
Latest version
git:20260324.12e2b3a, committed Mar 24, 2026
Size
6,389 bytes
Repository stars
79
License
MIT

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

# repo-scan -- 設計文件

> **English summary:** Design document for the `repo-scan` skill — a security scanning tool for evaluating GitHub repos before installation. Covers motivation, competitive landscape analysis (Anthropic's built-in /security-review, Trail of Bits skills, commercial AI-native SAST), the gap we identified (nobody scans Issues, nobody does full-repo audit from a URL), and key design decisions including why we scan GitHub Issues, why we assess maintainer health, and why the output is an opinion rather than a data dump.

---

## 這個 Skill 為什麼存在

我們活在 AI 開源工具的黃金時代。每週都有一個閃亮的新 GitHub repo 號稱會改變你的工作流程。你按了 star,clone 下來,`npm install`,然後祈禱不會出事。

劇透:有時候真的會出事。

現實是 -- 大多數開發者(包括我們自己)評估開源工具的方式是:掃一眼 README、看看 star 數、也許花 30 秒瞄一下程式碼。這不是盡職調查,這是擲硬幣但多了幾個步驟。

我們想要一個 skill,能幫我們做那些我們懶得手動做的事:真的讀完程式碼、檢查依賴、翻一下 issues、然後告訴我們「欸,這個你可能不要裝比較好。」

---

## 競品分析(又名「一定有人做過了吧?」)

動手寫之前,我們先查了一輪。結果發現很多人在做這塊,只是沒有一個完全符合我們的需求。

### 現有方案一覽

| 工具 | 它做什麼 | 它不做什麼 |
|------|---------|-----------|
| **Anthropic /security-review**(內建)| 掃你的 PR diff 找弱點。MIT license,隨 Claude Code 出貨。 | 只掃*你的*分支上*你的*修改。不能丟一個 GitHub URL 給它說「幫我看看這安不安全」。 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kerberosclaw/kc_ai_skills/repo-scan/docs/DESIGN.md@sha256:d364e4db65a44396

The line at the top of this page pins the label git:20260324.12e2b3a, 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_7sqwlhy5a3m2577h.svg)](https://markdownregistry.com/a/art_7sqwlhy5a3m2577h)

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

Versions

The registry has recorded 1 version of this file, committed on Mar 24, 2026.

versioncommittedcommitsizeaudit
git:20260324.12e2b3a latest2026-03-24 12e2b3a 6,389 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (6389 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

kerberosclaw/kc_ai_skills · 79 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7sqwlhy5a3m2577h
GET https://markdownregistry.com/api/v1/resolve?ref=kerberosclaw/kc_ai_skills/repo-scan/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/d364e4db65a4439675b8fb780583b8998a825db0b2b48ab0ffa2036e9073cc3e

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: what DESIGN.md is and how agents use it · which agent file does what.

More from kerberosclaw/kc_ai_skills

adr SKILL.md skill
kerberosclaw/kc_ai_skills · adr/SKILL.md · Use when a durable technical decision was just made in conversation and should be recorded, or when user asks to…
v0.3.1 · audit A · 79 stars
align SKILL.md skill
kerberosclaw/kc_ai_skills · align/SKILL.md · Reconcile existing repository documentation with the current implementation, especially after verified hotfixes or…
v0.4.0 · audit A · 79 stars
character-lora SKILL.md skill
kerberosclaw/kc_ai_skills · character-lora/SKILL.md · Use when the user wants to build a consistent-identity LoRA for an original character — defining the character…
v0.2.1 · audit A · 79 stars
conference-report SKILL.md skill
kerberosclaw/kc_ai_skills · conference-report/SKILL.md · Use when the user attended one or more sessions of a conference (with audio recordings + slide photos) and needs help…
v0.2.0 · audit A · 79 stars
ctf-kit SKILL.md skill
kerberosclaw/kc_ai_skills · ctf-kit/SKILL.md · Use when the user is solving an authorized CTF / lab reverse-engineering challenge focused on Windows application…
v0.5.0 · audit A · 79 stars
diagnose SKILL.md skill
kerberosclaw/kc_ai_skills · diagnose/SKILL.md · Use when the user reports misbehaving software to investigate — a bug, crash, wrong output, flaky behavior, or…
v0.3.0 · audit A · 79 stars
goal-engineer SKILL.md skill
kerberosclaw/kc_ai_skills · goal-engineer/SKILL.md · Author a self-contained unattended dispatch for a generate-and-select loop (generate candidates, grade, iterate, keep…
v1.3.2 · audit A · 79 stars
DESIGN.md@goal-engineer/docs DESIGN.md file
kerberosclaw/kc_ai_skills · goal-engineer/docs/DESIGN.md
git:20261015.be10792 · audit A · 79 stars
gpt-image-gen SKILL.md skill
kerberosclaw/kc_ai_skills · gpt-image-gen/SKILL.md · Use when the user asks to generate OR edit an image via GPT/Codex (e.g. 「叫 gpt 生圖」「幫我用 gpt 生圖」「gpt 畫一個…
v0.6.0 · audit A · 79 stars
grill SKILL.md skill
kerberosclaw/kc_ai_skills · grill/SKILL.md · Use when the user says 先討論 / wants to align on a fuzzy idea before building, or before any non-trivial implementation…
v0.1.0 · audit A · 79 stars
ios-resign SKILL.md skill
kerberosclaw/kc_ai_skills · ios-resign/SKILL.md · Use when the user wants to rebuild, re-sign and reinstall one of their own iOS apps onto their iPhone(s) — typically…
v0.1.1 · audit A · 79 stars
job-scout SKILL.md skill
kerberosclaw/kc_ai_skills · job-scout/SKILL.md · Use when the user is considering applying to, interviewing with, or accepting an offer from a company and wants due…
v1.1.0 · audit A · 79 stars

Every file in kerberosclaw/kc_ai_skills

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