ai-skills

AI Skills — Claude Code Plugin

Repository này là một Claude Code Plugin chứa engineering guidelines cho backend (Java/Spring Boot/Clean Architecture) và mobile (React Native) dành cho fintech/banking apps.

Plugin tự động inject đúng guidelines vào context khi Claude Code làm việc, giúp AI generate code nhất quán và production-ready.

---

Cài Đặt Trên Máy Mới

Bước 1 — Thêm marketplace vào ~/.claude/settings.json

Mở file ~/.claude/settings.json và thêm vào:

{
  "extraKnownMarketplaces": {
    "ai-skills": {
      "source": {
        "source": "github",
        "repo": "SilverPham08091998/ai-skills"
      }
    }
  },
  "enabledPlugins": {
    "ai-skills@ai-skills": true
  }
}

Nếu settings.json đã có extraKnownMarketplaces và enabledPlugins, chỉ cần merge thêm 2 key trên vào, không xoá các entry cũ.

Ví dụ khi đã có plugins khác:

{
  "extraKnownMarketplaces": {
    "claude-code-workflows": {
      "source": {
        "source": "github",
        "repo": "wshobson/agents"
      }
    },
    "ai-skills": {
      "source": {
        "source": "github",
        "repo": "SilverPham08091998/ai-skills"
      }
    }
  },
  "enabledPlugins": {
    "backend-development@claude-code-workflows": true,
    "ai-skills@ai-skills": true
  }
}

Bước 2 — Restart Claude Code

Đóng và mở lại Claude Code. Plugin sẽ tự động được tải từ GitHub.

Bước 3 — Kiểm tra

Trong Claude Code session, hỏi:

what instructions are you following?

Hoặc yêu cầu Claude dùng skill cụ thể:

Using java-core skill, review this code: ...

---

Dùng Cục Bộ (Local)

Nếu muốn dùng bản local thay vì GitHub:

{
  "extraKnownMarketplaces": {
    "ai-skills": {
      "source": {
        "source": "directory",
        "path": "/đường/dẫn/đến/ai-skills"
      }
    }
  },
  "enabledPlugins": {
    "ai-skills@ai-skills": true
  }
}

---

Danh Sách Skills (57 skills)

Backend — Clean Architecture (7)

Skill	Mô tả
clean-architecture-layers	Layer overview, dependency rules, ports & adapters
clean-architecture-common	Shared rules across all layers
clean-architecture-controller	Controller layer rules — thin, validation only
clean-architecture-application	Application/UseCase layer rules
clean-architecture-domain	Domain layer rules — rich model, invariants
clean-architecture-infrastructure	Infrastructure layer — adapters, clients
clean-architecture-mapper	Mapping rules between layers (MapStruct)

Backend — Code Review (4)

Skill	Mô tả
code-review-backend	Backend PR review checklist
code-review-performance	Performance review guidelines
code-review-pr-checklist	PR merge checklist
code-review-production-readiness	Production readiness checklist

Backend — Engineering (4)

Skill	Mô tả
engineering-clean-code	Clean code principles
engineering-coding-principles	Core coding philosophy (SOLID, SRP, etc.)
engineering-design-patterns	Standard design patterns usage
engineering-naming-convention	Naming rules for classes, methods, variables

Backend — Infrastructure (1)

Skill	Mô tả
infrastructure-datasource	HikariCP datasource configuration rules

Backend — Java (5)

Skill	Mô tả
java-core	Java core best practices (types, null, exceptions, streams)
java-collections	Collection usage rules
java-concurrency	Thread safety, executor usage
java-performance	JVM optimization, GC awareness
java-lombok-mapstruct	Lombok annotations + MapStruct mapping rules

Backend — Microservice Patterns (2)

Skill	Mô tả
microservice-outbox	Transactional Outbox pattern
microservice-master-slave	Master-Slave / Leader-Follower pattern

Backend — Spring Boot (8)

Skill	Mô tả
springboot-project-structure	Domain-first package structure
springboot-rest-api	REST API design standards
springboot-validation	Bean Validation, input validation rules
springboot-exception-handler	Global exception handling
springboot-security	Authentication, authorization, JWT
springboot-testing	Spring Boot testing strategy
springboot-logging	Structured logging with SLF4J/Logback/MDC
springboot-tracing	Distributed tracing (OpenTelemetry / Micrometer)

Backend — Testing (4)

Skill	Mô tả
testing-unit	Unit testing rules (JUnit 5, Mockito, AssertJ)
testing-api	API/Controller testing (MockMvc, @WebMvcTest)
testing-e2e	End-to-end testing strategy
testing-performance	Performance testing (k6, Gatling)

Mobile — Architecture (5)