Align
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 fixing code, deploying, inventing requirements, or building a new documentation suite.
Install
npx skills add KerberosClaw/kc_ai_skills --skill aligngit clone --depth 1 https://github.com/KerberosClaw/kc_ai_skills.git /tmp/kc_ai_skills
mkdir -p ~/.claude/skills
cp -r /tmp/kc_ai_skills/align ~/.claude/skills/alignPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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/派工執行 的完整無人值守 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/派工執行 主線的預設。 - **觸發範圍跑到一半**,發現同類落差明顯散到觸發事件之外:手動時回報並問要不要轉全庫重掃;無人值守時記成範圍外發現。都不自行擴大修訂範圍。 ## 執行流程 1. **確定目標、規則與範圍。** 使用明確指定的 repo,否則以目前 Git 根目錄為準;無法定位時才問。讀適用的 `AGENTS.md`/`CLAUDE.md`,wiki 型 repo 先讀 `SCHEMA.md`。記錄 HEAD 與既有工作區變更,保留他人的修改,不自動 stash、reset、切換版本或更新 checkout。接著照「對齊範圍」決定這次用哪一種。 2. **盤點。** 先讀 [references/criteria.md](references/criteria.md) 中對應範圍的覆蓋判準。
Details
- Skill name
align- Repository
- KerberosClaw/kc_ai_skills
- Path
align/SKILL.md- License
- MIT
- Repo updated
- 14 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Align skill do?
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 fixing code, deploying, inventing requirements, or building a new documentation suite.
How do I install the Align skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add KerberosClaw/kc_ai_skills --skill align. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Align popular?
It lives in KerberosClaw/kc_ai_skills, which has 80 GitHub stars and 13 forks, and is included in 1 curated skill list.
Related skills
Adr
80KerberosClaw/kc_ai_skills
Use when a durable technical decision was just made in conversation and should be recorded, or when user asks to write/record an ADR (開 ADR / 記個決策 / 這要不要 ADR). Runs a three-gate check FIRST and actively talks the user out of writing one when the decision doesn't qualify — then writes a lightweight (title + 1-3 sentences) ADR following the repo's own ADR conventions if any exist. Repo conventions always override this skill's defaults. NOT for requirement specs (spec / prd-create) or rewriting historical decisions; preserve their text, allow evidence-backed current-state notes, and record change
Character Lora
80KerberosClaw/kc_ai_skills
Use when the user wants to build a consistent-identity LoRA for an original character — defining the character, generating a face/body-consistent multi-angle dataset (via the gpt-image-gen skill for codex image generation), captioning it, doing base-specific homework, training on a chosen base (Pony / Z-Image / others) on a local GPU, and producing a usable LoRA. This skill ORCHESTRATES the end-to-end pipeline and gates every expensive/irreversible step; it delegates actual image generation to gpt-image-gen and never improvises training settings from memory.
Conference Report
80KerberosClaw/kc_ai_skills
Use when the user attended one or more sessions of a conference (with audio recordings + slide photos) and needs help building (1) faithful per-session reconstructions in markdown (slide visuals + speaker transcript with Whisper hallucination annotations), and (2) a downstream report deliverable whose scope and format are decided interactively with the user. Pipeline phase (raw → mlx_whisper Chinese SRT → per-slide multimodal reconstruction → official agenda cross-check via Playwright if available) is deterministic. Report phase is interactive — always quiz user on scope (single-session / sing
Rendering Untrusted Content
115wdm0006/python-skills
Renders stored, authored, or imported content into HTML without shipping XSS — auditing every autoescape bypass (|safe, Markup, innerHTML), sanitizing Markdown output with an allowlist, escaping on both the server and the DOM, and writing sanitization tests that assert on the right copy of the string. Use when adding a Markdown or rich-text filter, rendering user/admin-authored content, reviewing a template that marks HTML trusted, building a client that injects values into innerHTML, or fixing an XSS report.
Rewrite Tone
80KerberosClaw/kc_ai_skills
Use when the user wants to rewrite Markdown prose into a conversational, humorous, self-deprecating engineering tone while preserving technical accuracy and document structure. Rewrites prose sections only, keeps code blocks, diagrams, tables, English summary blocks, and factual claims intact. NOT for changing requirements, adding new technical content, or editing non-Markdown artifacts.
Translate Book
44kcy4334-lgtm/translate-book-arxiv
Translate an arXiv paper, or any PDF/DOCX/EPUB book, into any language as a printable book. For arXiv papers it reads the LaTeX source, so equations, tables, figures and numbering survive. Parallel sub-agents translate the chunks; output is HTML, DOCX, EPUB and PDF.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.