Phần lớn developer có GitHub repo nhưng repo đó không ai thấy. Không phải vì code kém. Mà vì README thiếu keyword, description viết sai, topics không đúng, và không có CONTRIBUTING hay SECURITY.md. claude code github là bộ 8 skills giúp Claude Code tự động audit toàn bộ repo, chấm điểm 0-100, và fix từng vấn đề theo thứ tự ưu tiên. Cài bằng một lệnh, chạy trong 5 phút.
Mình đã dùng claude code github để audit một repo có 2 năm tuổi. Score ban đầu là 34/100. Sau khi chạy hết 8 skills, score lên 81/100 và repo bắt đầu xuất hiện trong GitHub search. Bài này là hướng dẫn đầy đủ từ cài đặt đến từng command cụ thể.
claude-github là skill suite tối ưu GitHub repo toàn diện: 8 sub-skills (audit, readme, seo, meta, legal, community, release, empire), chấm điểm 0-100 theo 6 danh mục song song, tích hợp DataForSEO cho live keyword research, và KIE.ai để tự tạo banner. Cài bằng bash install.sh rồi gõ /github audit để bắt đầu.
GitHub Repo Của Bạn Đang Invisible Thế Nào?
Theo GitHub Octoverse 2025, nền tảng hiện có hơn 630 triệu repositories và thêm hơn 121 triệu repo mới trong năm 2025 tức 230 repo mới mỗi phút. Trong 630 triệu repo đó, phần lớn invisible hoàn toàn. Không ai tìm thấy, không ai star, không ai dùng.
Vấn đề không phải code. Vấn đề là presentation. Một repo thiếu README keyword thì GitHub search không hiểu nó làm gì. Một repo không có topics thì không xuất hiện trong GitHub Explore. Một repo thiếu SECURITY.md và CONTRIBUTING.md thì trông không professional, contributor tiềm năng sẽ bounce ngay.
Mình đã xem hàng chục repo của developer Việt Nam. Pattern lặp đi lặp lại: description trống, README 3 dòng, topics sai hoặc không có, không có license, không có changelog. Tất cả có thể fix trong 30 phút với claude code github, nhưng hầu hết không biết tool này tồn tại.
Nếu bạn chưa rõ cài đặt Claude Code như thế nào, đọc bài đó trước khi tiếp tục.
claude-github Là Gì, Và Tại Sao Không Chỉ Dùng ChatGPT?
claude code github là skill suite gồm 8 sub-skills chuyên biệt, mỗi cái đảm nhận một khía cạnh của GitHub repo optimization. Không phải một prompt tổng quát “hãy tối ưu repo của tôi.” Mà là 8 agents có data riêng, workflow riêng, và output có thể apply ngay.
Sự khác biệt so với ChatGPT hoặc Claude thuần? ChatGPT không thể gọi gh repo view, không thể đọc file LICENSE thực tế trong repo, không kết nối với DataForSEO để lấy keyword volume thật, không tự generate banner bằng KIE.ai. Claude code github chạy trong môi trường của Claude Code, có quyền truy cập terminal, GitHub CLI, và MCP servers. Nó làm thật, không chỉ gợi ý.
Pattern GARE mà suite dùng: Gather (thu thập data từ repo thực), Analyze (so sánh với chuẩn theo repo type), Recommend (đề xuất với source cụ thể), Execute (apply thay đổi sau khi bạn confirm). Mọi recommendation đều có nguồn rõ ràng, không phải ý kiến chủ quan.
Xem thêm tổng quan về Claude Code Skills để hiểu cách skill system hoạt động trước khi đi vào từng command.
8 Sub-Skills Trong claude-github Làm Được Gì?
claude code github bao gồm 8 sub-skills với vai trò riêng biệt. Chạy theo thứ tự chuẩn dưới đây để tránh skip dependencies.
Mỗi skill dùng chung data cache (.github-audit/ folder) để tránh gọi API lại. Skill chạy trước lưu data, skill sau đọc lại. Không cần bạn giải thích repo mình đang làm gì cho từng skill riêng lẻ.
Để hiểu cơ chế kỹ thuật sub-agents song song mà /github audit dùng để chấm điểm 6 danh mục cùng lúc, đọc bài riêng về topic đó.
Cài Đặt claude-github Trong 5 Phút
claude code github yêu cầu ba thứ trước khi cài: Claude Code đang chạy, Git, và GitHub CLI. Nếu chưa có GitHub CLI, cài bằng winget install GitHub.cli trên Windows hoặc brew install gh trên macOS, rồi chạy gh auth login để authenticate.
Bước 1: Clone và cài
# Clone repo (private, cần GitHub account được grant access)
git clone https://github.com/avalonreset-pro/claude-github.git
cd claude-github
# Cài skills vào ~/.claude/skills/
bash install.sh # macOS/Linux
# hoặc: powershell -File install.ps1 # WindowsScript install.sh copy toàn bộ skills vào ~/.claude/skills/github/ và hướng dẫn setup DataForSEO (optional, ~5 phút thêm nếu muốn live keyword data) và KIE.ai API key (optional, cho banner generation).
Bước 2: Chạy audit đầu tiên
# CD vào repo bạn muốn optimize
cd /path/to/your-repo
# Khởi động Claude Code
claude
# Chạy audit
/github auditNếu muốn audit một repo remote mà không cần clone về:
/github audit username/repo-name
# Ví dụ:
/github audit facebook/react
/github audit microsoft/vscode
Audit chạy 6 agents song song trong khoảng 30-60 giây (tùy repo size). Output là danh sách prioritized actions: Critical block discoverability, High ảnh hưởng professional appearance, Medium là optimization opportunity.
/github seo và /github meta cần nó để có live keyword volume. Các skills còn lại (audit, legal, community, release, readme, empire) hoạt động độc lập.
/github audit: Repo Của Bạn Được Mấy Điểm?
claude code github audit là điểm vào của mọi workflow. Skill này spawn 6 agents song song, mỗi agent phụ trách một danh mục, chấm điểm theo weight cố định, rồi merge kết quả thành Health Score tổng.
Sáu danh mục và weight của chúng trong claude code github audit:
- README Quality (25%): Cấu trúc, keyword density, heading hierarchy, code examples, badges
- Metadata & Discovery (20%): Description, topics, homepage URL, social preview image
- Legal Compliance (15%): LICENSE file, SECURITY.md, CITATION.cff, fork obligations
- Community Health (15%): CONTRIBUTING.md, CODE_OF_CONDUCT.md, issue/PR templates
- Release & Maintenance (15%): CHANGELOG, releases, last commit date, versioning
- SEO & Discoverability (10%): Keywords trong README headings, Google indexability, AI citability
Score dưới 40: repo invisible, fix ngay trước khi làm gì khác. 40-70: cơ bản ổn nhưng còn nhiều điểm thiếu. Trên 70: professional, Google và GitHub search sẽ index tốt hơn. Mình chưa thấy repo nào chưa optimize mà đạt trên 70 lần đầu audit.
Sau audit, skill sinh ra file .github-audit/repo-context.json với toàn bộ data để các skills sau dùng lại. Đây là lý do tại sao audit phải chạy đầu tiên trong workflow chuẩn.
3 Skills Nào Nên Chạy Ngay Sau Audit?
Nếu bạn chỉ có 30 phút, ba skills dưới đây tạo tác động lớn nhất theo thứ tự. Chạy đúng thứ tự vì /github readme phụ thuộc vào output của /github seo.
/github seo: Keyword Research Cho README
claude code github seo giải quyết một vấn đề thực tế: GitHub repo KHÔNG phải website thông thường. Bạn không thể build backlinks, không thể control meta tags, không thể optimize page speed. Cái duy nhất bạn control là nội dung README, description, và topics.
Khi DataForSEO MCP được cấu hình, claude code github seo tìm ra Sweet Spot keywords: volume 100-5,000 lượt/tháng, difficulty dưới 40, và GitHub repos xuất hiện trong top 20 Google results cho keyword đó. Chỉ những keyword này mới đáng target trong README.
/github seoOutput: bảng keyword với volume, difficulty, và GitHub Viability score. Primary keyword sẽ vào H1 và description. Secondary keywords vào H2 headings. Topic keywords vào GitHub topics list. Chi phí DataForSEO cho một repo: khoảng 10-15 cents (2 keyword_suggestions + 1 SERP check).
Nếu bạn muốn hiểu cách DataForSEO được integrate qua MCP servers Claude Code, có bài riêng giải thích cách setup MCP servers nói chung.
/github readme: README + Banner Tự Động
Đây là skill có tác động visual lớn nhất trong claude code github. Nó đọc SEO data từ .github-audit/seo-data.json, đọc repo context, và tạo một README mới với heading hierarchy, badge row, table of contents, installation section, usage examples với code blocks, và contributing section.
Keyword placement cụ thể: primary keyword vào H1 title, secondary keywords vào H2 headings, topic keywords vào description paragraph. Không phải keyword stuffing mà là placement có chủ đích theo cách Google indexing đọc GitHub README.
KIE.ai integration tự generate banner 21:9 aspect ratio. Banner xuất hiện trên đầu README, là thứ đầu tiên visitor thấy trước khi đọc bất cứ thứ gì. Đây thực chất là thay thế cho việc ngồi mở Figma hay Canva thủ công.
/github meta: Description, Topics, Social Preview
Description 350 ký tự của GitHub repo chính là OG description khi ai đó share link repo trên Twitter hay LinkedIn. claude code github meta viết description tối ưu dùng primary keyword từ /github seo, đề xuất 10-20 topics theo GitHub Explore taxonomy, và hướng dẫn cụ thể từng bước để set social preview image.
/github metaTopics mà skill đề xuất không phải ngẫu nhiên. Chúng được chọn dựa trên ba yếu tố: keyword volume từ DataForSEO, tần suất xuất hiện trong repos tương tự đang có nhiều stars, và GitHub Explore category alignment. Việc thêm đúng topics giúp repo xuất hiện trong “Explore” feed của developers đang tìm tools tương tự.
Nếu bạn muốn build thêm skills tùy chỉnh cho GitHub workflow của mình, xem cách tự tạo Claude Code skill và bộ sưu tập skills tốt nhất hiện có.
/github empire: Khi Bạn Quản Lý Nhiều Repos?
claude code github empire là skill khác về bản chất so với 7 skills còn lại. Nó không tối ưu một repo mà tối ưu toàn bộ GitHub presence: profile bio, profile README, cross-linking giữa repos, topic sync, và pinned repos strategy.
Điểm phân biệt: empire skill làm thật qua GitHub API thay vì chỉ hướng dẫn. Nó gọi gh api user -X PATCH để update bio, tạo repo username/username cho profile README, push file trực tiếp, và update topics trên nhiều repos trong một batch. Những thứ cần manual (upload social preview, thay avatar) thì skill cung cấp link trực tiếp đến đúng trang settings.
# Audit toàn bộ portfolio của một user
/github audit username
# Tối ưu portfolio
/github empireEmpire workflow bao gồm: scan tất cả public repos, identify overlap trong topics (thường repos không share chung topics nên không cross-link được), viết profile README với pinned repos section, và tạo cross-linking sections trong README của từng repo trỏ đến các repos liên quan. Kết quả: visitor vào một repo của bạn sẽ tự nhiên khám phá ra các repos khác.
Workflow chuẩn: chạy hết 7 skills trên từng repo riêng lẻ trước, rồi mới chạy empire ở cuối. Empire assume từng repo đã clean, tối ưu, và professional. Chạy empire trên repos chưa optimize là lãng phí, vì cross-linking sẽ dẫn visitor đến repos kém chất lượng.
claude code github empire cũng liên quan đến việc sử dụng GitHub Actions nếu bạn muốn tự động hóa audit theo lịch định kỳ, tuy nhiên đó là workflow riêng biệt nằm ngoài phạm vi của suite này.
Câu Hỏi Thường Gặp
claude-github khác gì với việc nhờ ChatGPT “tối ưu repo của tôi”?
ChatGPT không có quyền truy cập repo thực, không gọi được gh repo view, không đọc LICENSE file, không lấy keyword volume từ DataForSEO. Nó chỉ đưa ra lời khuyên chung chung. claude code github chạy trong môi trường Claude Code, đọc data thực từ repo của bạn, gọi GitHub CLI, và apply thay đổi trực tiếp sau khi bạn confirm. Mọi recommendation đều có nguồn cụ thể thay vì “dựa trên best practices.”
Không có DataForSEO thì suite còn dùng được không?
Dùng được. DataForSEO chỉ cần thiết cho /github seo và phần keyword research trong /github meta và /github readme. Sáu skills còn lại (audit, legal, community, release, empire, và phần lớn của meta) không cần DataForSEO. Nếu không có, /github seo vẫn chạy nhưng dùng codebase analysis thay vì live search volume data.
Repo private có dùng được không?
Được, miễn là GitHub CLI đã authenticate với account có quyền truy cập repo đó. gh auth status để kiểm tra. Suite không cần repo public. /github audit chạy được cả trên private repos theo cùng flow.
Có tương thích Windows không?
Có. Suite có cả install.ps1 cho Windows và install.sh cho macOS/Linux. GitHub CLI (winget install GitHub.cli) và Claude Code đều native support Windows. DataForSEO extension cũng có extensions/dataforseo/install.ps1 riêng.
Chi phí DataForSEO mỗi repo là bao nhiêu?
Khoảng 10-15 cents mỗi repo (2 lần gọi keyword_suggestions + 1 lần gọi serp_organic_live_advanced). Với portfolio 10 repos khoảng $1-1.5. Suite sẽ báo estimate trước khi chạy portfolio-level analysis và chờ confirm. DataForSEO có free tier đủ để test.
Workflow chuẩn chạy theo thứ tự nào?
Thứ tự 8 bước: audit (chẩn đoán) → legal → community → release → seo → meta → readme → audit lại (kiểm tra delta). Không skip, vì mỗi skill viết data vào cache mà skill sau cần đọc. README phải chạy cuối vì nó consume output của tất cả skills trước.
Kết Luận
claude code github giải quyết một vấn đề mà hầu hết developer bỏ qua: code tốt nhưng repo invisible. 630 triệu repos trên GitHub nghĩa là cạnh tranh khốc liệt về discoverability. Không có keyword đúng, không có README structure, không có topics phù hợp thì repo của bạn chìm trong đám đông đó.
Bắt đầu bằng /github audit. Xem repo bạn được mấy điểm. Nếu cần visualize architecture của repo, dùng thêm excalidraw-diagram skill để tự generate diagram. Sau đó chạy lần lượt: legal, community, release, seo, meta, readme. Mỗi skill nhỏ, mỗi step rõ ràng. Toàn bộ workflow mất khoảng 30-45 phút cho một repo lần đầu, nhanh hơn nhiều lần sau khi đã quen.
Nếu bạn muốn không chỉ tối ưu GitHub mà còn muốn Claude Code làm SEO cho website, xem thêm bài về Claude Code SEO để có bức tranh đầy đủ hơn về việc dùng Claude Code cho toàn bộ content và technical pipeline.
