Skills Guide

Codebase Knowledge Curator

VerifiedCaution

Extracts non-obvious knowledge from sessions and records it in skill/ at the right place, with grep-based deduplication and user approval before writing.

Download and use
Sby Skills Guide Bot
DocumentationIntermediate
11/3/2026
Claude Code
#knowledge-base#deduplication#session-capture#skill-curation#codebase-docs

Recommended for

Claude CodeAuto documentation

Automated summary

Captures the durable lessons of a development session and files them into the Cluvix repository's `skill/` knowledge base, in the right file and format, without duplicates and only after user approval.

Strengths

  • Three-part filter (non-obvious, reusable, traceable to the session) with a cap of 5 entries per session to keep signal high.
  • Mandatory grep dedup before any proposal, with three explicit outcomes: drop, update with only the delta, or add.
  • Clean propose/write separation: nothing is written before approval, then a gate of 7 verification scripts runs immediately after the write.
  • Enforces size limits (SKILL.md ≤ 500 body lines, split into reference/ beyond that, TOC past 100 lines) to keep the knowledge base readable.

Limitations

  • Assumes a specific layout (skill/, frontend/skill/, mobile/skill/, skill/skills/_tooling/*.sh) that a typical repo does not have.
  • Hardcodes an absolute path (/Users/KemBi/www/erp-cluvix) and tolerates one pre-existing verify-no-dup failure, so it is not portable as-is.
  • Relies on an external `skill/HOW_TO_UPDATE.md` that is not included; without it the target-file selection and write format are undefined.
When to use it

Use it at the end of a Cluvix development session when a gotcha, edge case or reusable rule has just surfaced and should be added to the knowledge base.

When not to use it

Do not use it on a project lacking Cluvix's `skill/` structure, or for writing end-user documentation and tutorials.

Security analysis

Caution
Quality score78/100

The skill is a documentation/knowledge-curation workflow: it greps for duplicates, proposes entries, waits for user approval, then writes markdown and runs the repository's own verification scripts. Nothing exfiltrates data, obfuscates payloads, or performs destructive filesystem operations, so it is not risky. It is rated caution only because it depends on bash execution of local scripts and file writes, plus a hardcoded developer path.

Findings
  • •Hardcoded absolute local path in the mandatory gate step (`cd /Users/KemBi/www/erp-cluvix`), which both leaks a developer username/path and will fail or act on the wrong directory if run elsewhere.
  • •Runs a loop of repo-local shell scripts (`skill/skills/_tooling/*.sh`) with no allowlist or integrity check; this is legitimate tooling but grants arbitrary code execution from whatever is in that directory.
  • •Instructs the agent to write/modify files across multiple knowledge-base directories (`skill/`, `frontend/skill/`, `mobile/skill/`) with only a human-approval gate as a safeguard — no tool allowlist declared.
  • •Instructs the agent to run shell verification scripts (skill/skills/_tooling/*.sh) via a bash loop, giving code execution reach over the repo — legitimate but unverified in this listing
  • •Uses grep over multiple directories and writes/edits files under skill/, frontend/skill/, mobile/skill/ without an explicit approval gate beyond the user-approval step
  • •Embeds a hardcoded local absolute path (/Users/KemBi/www/erp-cluvix) that leaks a developer username/machine layout and will break on other machines
How this analysis is made

Examples

Save lessons from a session
On vient de corriger le bug de cache dans le module facturation. Propose les entrées à sauvegarder dans skill/ en faisant le dedup grep et en indiquant le fichier cible pour chacune.
Add a business rule
Ajoute dans la base de connaissances la règle métier qu'on vient de clarifier sur les arrondis de TVA, après vérification qu'elle n'existe pas déjà dans skill/, frontend/skill/ ou mobile/skill/.
Run the verification gate
Lance les scripts de skill/skills/_tooling/ pour vérifier que la dernière entrée ajoutée ne crée pas de doublon et que les liens et le frontmatter sont valides, puis fais le rapport final.

Knowledge curator cho codebase Cluvix — trích xuất từ session và ghi vào skill/ đúng chỗ, đúng format, KHÔNG trùng lặp.

Bước 0 — Đọc trước

Đọc skill/HOW_TO_UPDATE.md — source of truth về cách ghi. Không làm gì trái với file đó.

Bước 1 — Extract: Cái gì đáng lưu?

Lọc từ conversation hiện tại. Chỉ giữ những gì thỏa cả 3 điều kiện:

A — Non-obvious: không đọc code thì không biết · lần sau vẫn có thể mắc lại · là gotcha/edge case/quyết định kiến trúc không hiển nhiên.

B — Tái sử dụng được: áp dụng nhiều feature/module · là pattern/rule, không phải fix cho 1 bug cụ thể.

C — Có gốc tích trong session: chỉ ra được khoảnh khắc cụ thể sinh ra nó (bug vừa sửa, behavior gây bất ngờ, quyết định user vừa chốt). Không lưu "kiến thức chung" đúng ở mọi codebase (SOLID, nhớ unsubscribe, đặt tên rõ ràng...).

Ràng buộc số lượng — chất lượng > số lượng:

  • Mặc định 1–3 mục/session, tối đa 5. Nhiều hơn → đang lưu cả impl detail, lọc lại.
  • 1 mục = 1 fact. Không gộp nhiều rule thành 1 mục dài; không kể chuyện quá trình.

Loại bỏ: chi tiết impl task vừa làm · thứ đọc code là hiểu · context lịch sử ("trước đây là X, giờ đổi thành Y" → chỉ ghi Y) · thứ git/CLAUDE.md đã ghi.

Bước 2 — Dedup check TRƯỚC khi propose (bắt buộc từng mục)

grep -rn "<keyword>" skill frontend/skill mobile/skill --include="*.md"   # thử 2-3 keyword/biến thể mỗi mục

| Kết quả grep | Action | |---|---| | Đã có, cùng ý | LOẠI mục này — không đề xuất | | Đã có một phần / sai / thiếu | Đổi thành UPDATE file hiện có (nêu rõ skill + section, chỉ ghi phần delta) | | Chưa có | ADD — chọn skill đích theo bảng Step 1 của HOW_TO_UPDATE.md, ưu tiên skill hẹp nhất/đúng domain nhất (vd nghiệp vụ module cụ thể > hard-rules > cross-cutting) |

Mục nào chưa grep → chưa được đưa vào đề xuất.

Bước 3 — Propose (KHÔNG ghi trước khi user duyệt)

## Đề xuất lưu vào skill/

### 1. [Tên ngắn gọn]
- Loại: rule / pattern / gotcha / business / config
- Gốc tích: [1 câu — từ đâu trong session]
- Dedup: 0 hit với "<keyword>" / đã có ở file X §Y → UPDATE phần delta
- File đích: skill/skills/<skill-name>/SKILL.md hoặc .../reference/<file>.md (frontend/skill/skills/... hoặc mobile/skill/skills/... nếu thuộc repo con)
- Action: UPDATE section "X" / ADD vào section "Y" / TẠO reference/ MỚI (phải thỏa 3 điều kiện của HOW_TO_UPDATE)
- Nội dung sẽ ghi (≤ 5 dòng + code block nếu cần):
  [bullet rule-trước, không "tại sao" trừ khi non-obvious, không narrative]

Hỏi: "Bạn muốn lưu mục nào? (all / 1,3 / none)"

Bước 4 — Thực thi (sau khi user duyệt)

  1. Ghi ĐÚNG nội dung đã duyệt ở Bước 3 — không phình thêm khi ghi
  2. UPDATE → sửa in-place đúng section, diff tối thiểu, không format lại phần không liên quan
  3. Tạo reference/*.md mới → đảm bảo SKILL.md của skill đó trỏ tới file mới (progressive disclosure)
  4. Verify: grep lại keyword — chỉ xuất hiện 1 lần trong toàn bộ knowledge base (skill/ + frontend/skill/ + mobile/skill/)
  5. Verify: SKILL.md sau edit ≤ 500 dòng body — vượt thì tách sang reference/ theo Step 4 HOW_TO_UPDATE; reference/*.md >100 dòng phải có mục lục

Gate bắt buộc — chạy NGAY sau khi ghi, TRƯỚC khi báo Bước 5

cd /Users/KemBi/www/erp-cluvix
for s in verify-paths verify-links verify-symbols verify-frontmatter verify-depth verify-no-dup verify-orphan; do skill/skills/_tooling/$s.sh || echo "GATE FAIL: $s"; done

TỪ CHỐI kết thúc nếu có GATE FAIL mới — sửa ngay, không để lại cho session sau. Lý do: chặn lúc ghi (vài giây) rẻ hơn nhiều so với gom lại xử sau vài tháng.

⚠ Ngoại lệ đã biết: verify-no-dup.sh đỏ sẵn 1 nhóm (file bmad-plan.md của FE trùng của mobile) — nợ cũ chưa xử, được phép giữ đỏ. Bất kỳ finding nào KHÁC nhóm đó (kể cả từ verify-no-dup.sh) là finding MỚI → không được bỏ qua.

Bước 5 — Báo cáo

## Đã lưu
| Mục | File | Action |
|-----|------|--------|

## Bỏ qua (kèm lý do: trùng / obvious / impl detail / user từ chối)
| Mục | Lý do |
|-----|-------|

Cấm tuyệt đối

  • Ghi trước khi user duyệt
  • Đề xuất mục chưa grep dedup
  • Narrative quá trình ("trong session này ta đã thử A rồi B...")
  • Gộp nhiều fact vào 1 mục · mở section mới khi ghép được vào section có sẵn
  • Ghi lại thứ chỉ đúng cho task vừa làm, không tái sử dụng được

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/codebase-knowledge-curator-mvg6ty4w/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/codebase-knowledge-curator-mvg6ty4w' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/codebase-knowledge-curator-mvg6ty4w/download' --output '.skill-downloads/codebase-knowledge-curator-mvg6ty4w/SKILL.md.part' && mv '.skill-downloads/codebase-knowledge-curator-mvg6ty4w/SKILL.md.part' '.skill-downloads/codebase-knowledge-curator-mvg6ty4w/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

This file does not provide a usable name/description header for this native procedure. It remains available to download and inspect; use the manual method below.

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/codebase-knowledge-curator-mvg6ty4w/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills

Supabase Docs Authoring

Documentation

Write, edit, and review Supabase documentation content including guides, tutorials, reference docs, and partials. Follow style guides and MDX/TOML validation rules.

Claude CodeintermediateSafe 108,544
Skills Guide Bot

Create Architecture Decision Record

Documentation

Create a new Architecture Decision Record with sequential numbering, register it in the AgentDB graph, and link related ADRs.

Claude CodeintermediateSafe 69,659
Skills Guide Bot

Plan update with deep research

Documentation

Updates a plan document by launching parallel subagents to analyze a topic across all compiler passes, then consolidates findings into the plan doc.

Claude CodeadvancedSafe 248,015
Skills Guide Bot