align SKILL.md skillA

align from kerberosclaw/kc_ai_skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kerberosclaw/kc_ai_skills/align@v0.4.0

Pins v0.4.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kerberosclaw/kc_ai_skills
Path
align/SKILL.md
Versions recorded
3
Latest version
v0.4.0, committed Oct 16, 2026
First version recorded
Oct 15, 2026
Size
9,603 bytes
Repository stars
79
License
MIT

Reconcile existing repository documentation with the current implementation, especially after verified hotfixes or after QA in an unattended task. A manual run first asks whether to align only the docs a specific change touched (trigger scope) or rescan the whole repo; unattended runs use the scope the dispatch states and default to the whole repo. Follow cross-repo references for evidence; edit only documentation in the authorized repo, annotating conflicting historical records. Not for…

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

# align — 讓文件跟上實作

以目前實作與可查證的執行紀錄補齊既有文件,適用於 hotfix 後文件沒跟上,或無人值守任務跑完 QA 後的全 repo 對齊。呼叫本 skill 即授權修改目標 repo 的文件;user 明確要求唯讀時,只回報落差。

## 使用方式

```text
/align
/align /path/to/repo
這個 repo 跑一輪文件對齊
/align 只對齊這次刪掉 legacy/ 目錄的影響
/align 全庫重掃
無人值守執行 align,目標 /path/to/repo
```

有兩種入口:在 repo 內用 `/align` 或「文件對齊」等關鍵字直接呼叫;無人值守任務跑完 QA 後,也可以接著跑一輪,再由原任務收尾回報完成。手動呼叫不要求先跑 QA;align 不代替 QA,不處理開票、結案或歸檔,也不建立排程。

spec/goal-engineer 的完整無人值守 build 主線為 **實作與 AC/測試驗證 → `doc-qa:qa` 適用性與必要實跑 → align → 收尾回報**。接收前一階段的 QA 報告、版本與證據;已查證無 UI 時承接不適用結論與原 AC/適用驗證,不把它改成 UI PASS。若有 UI 卻未實跑或仍有缺陷,可處理已確定的文件落差,但保留缺口,不改需求或 QA 結果替缺陷背書。align 完成後回到原執行 agent 統一回報。

## 對齊範圍

| 範圍 | 適合的情況 | 做法 |
|---|---|---|
| **觸發範圍** | 起因是一件明確的改動:某個 hotfix、刪除或搬走的檔案/目錄、改名的介面/參數/指令、某段 commit 區間 | 從觸發事件列出搜尋鍵,在整個 repo 找引用到它的文件,只查證、修訂這些;範圍外看到的落差只記錄 |
| **全庫重掃** | 沒有單一起因、很久沒對齊、交接或發布前、無人值守主線 QA 後 | 照下方流程盤點整個 repo |

怎麼決定:

- **手動呼叫**:第 1 步完成後、開始盤點前,先問 user 要用哪一種。只問這一題,並附上建議:辨認得出具體觸發事件就建議觸發範圍,且把你辨認出的事件寫進選項讓 user 確認;辨認不出就建議全庫重掃。user 的請求已講明範圍(例如「只對齊這次刪除的影響」「全庫重掃」)就不再問。
- **無人值守**:不問。照 dispatch 指定的範圍;沒指定就全庫重掃,這是 spec/goal-engineer 主線的預設。
- **觸發範圍跑到一半**,發現同類落差明顯散到觸發事件之外:手動時回報並問要不要轉全庫重掃;無人值守時記成範圍外發現。都不自行擴大修訂範圍。

## 執行流程
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kerberosclaw/kc_ai_skills/align@sha256:2e3c9a42e0dfc802

The line at the top of this page pins the label v0.4.0, 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_q2rvhu5cftllq4xc.svg)](https://markdownregistry.com/a/art_q2rvhu5cftllq4xc)

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

Versions

The registry has recorded 3 versions of this file, between Oct 15, 2026 and Oct 16, 2026, more than one a day.

versioncommittedcommitsizeaudit
v0.4.0 latest2026-10-16 1759177 9,603 BA view · diff
v0.3.02026-10-15 209edbd 7,170 BA view · diff
v0.2.12026-10-15 be10792 7,063 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 (9603 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_q2rvhu5cftllq4xc
GET https://markdownregistry.com/api/v1/resolve?ref=kerberosclaw/kc_ai_skills/align
GET https://markdownregistry.com/api/v1/blob/2e3c9a42e0dfc802b485a38ec8b2c05e0ebe12ceca8132cfd808d806e9ce8c85

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 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
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
llm-benchmark SKILL.md skill
kerberosclaw/kc_ai_skills · llm-benchmark/SKILL.md · Use when the user wants to test, compare, or choose local Ollama models for their machine. Checks Ollama/GPU state…
v1.1.0 · audit B · 79 stars

Every file in kerberosclaw/kc_ai_skills

Other files named align

align SKILL.md skill
dkstm95/hope · plugins/hope/skills/align/SKILL.md · Resolve consequential choices and shared intent before implementation. Use only when explicitly invoked.
git:20260928.ff3dfa2 · audit A · 8 stars
align SKILL.md skill
hmmhmmhm/aligns.md · benchmarks/effort/results/2026-10-15-astra-v1-failed/source-snapshot/skills/align/SKILL.md · Establish and maintain personal project alignment in ALIGN.md. Use when goals or priorities are unclear, important…
v0.2.0 · audit A · 6 stars
align SKILL.md skill
hmmhmmhm/aligns.md · tests/activation/results/2026-10-17-additional/source/skill/SKILL.md · Establish and maintain personal project alignment in ALIGNS.md, including selected PR or conversation history review…
v0.5.0 · audit A · 6 stars
align SKILL.md skill
hmmhmmhm/aligns.md · tests/activation/results/2026-10-17-baseline/source/skill/SKILL.md · Establish and maintain personal project alignment in ALIGNS.md, including selected PR or conversation history review…
v0.5.0 · audit A · 6 stars
align SKILL.md skill
hmmhmmhm/aligns.md · benchmarks/discovery/results/2026-10-15-astra-v1/source-snapshot/skills/align/SKILL.md · Establish and maintain personal project alignment in ALIGN.md. Use when goals or priorities are unclear, important…
v0.2.0 · audit A · 6 stars
align SKILL.md skill
hmmhmmhm/aligns.md · tests/activation/results/2026-10-17-loop-final/source/skill/SKILL.md · Establish and maintain personal project alignment in ALIGNS.md, including selected PR or conversation history review…
v0.5.2 · audit A · 6 stars
align SKILL.md skill
hmmhmmhm/aligns.md · benchmarks/effort/results/2026-10-15-astra-v2/source-snapshot/skills/align/SKILL.md · Establish and maintain personal project alignment in ALIGN.md. Use when goals or priorities are unclear, important…
v0.2.0 · audit A · 6 stars
align SKILL.md skill
hmmhmmhm/aligns.md · tests/activation/results/2026-10-17-general-v052/source/skill/SKILL.md · Establish and maintain personal project alignment in ALIGNS.md, including selected PR or conversation history review…
v0.5.2 · audit A · 6 stars

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