⚡ Anachak Agent Skills

Production-grade SKILL.md skills for a full-stack Rust + React SaaS platform.
Drop them into any Claude Code, Codex CLI, or SKILL.md-compatible agent and get instant deep knowledge of the codebase architecture.

---

🗂️ What's Inside

This repository contains four SKILL.md skill packages plus supporting workflow and rule files for the Anachak multi-tenant SaaS platform — a Rust gRPC backend + React frontend stack.

rust-skill/
├── skills/
│   ├── backend-rust/        # Rust gRPC backend — 11 modules, 32 utils, 90+ RPCs
│   ├── frontend-web/        # React 19 SPA — TanStack Router, ConnectRPC, Tailwind v4
│   ├── deployment/          # CI/CD — GitHub Actions, Docker, Cloud Run, K8s
│   └── terminal-fish/       # Dev environment — Fish shell, aliases, gRPC debugger
├── workflows/               # Step-by-step agent workflow guides
│   ├── new-module.md
│   ├── new-endpoint.md
│   ├── new-page.md
│   ├── db-migration.md
│   ├── deploy.md
│   ├── proto-gen.md
│   ├── dev.md
│   └── check.md
└── rules/                   # Code-quality and pattern enforcement rules
    ├── backend-rust.md
    └── frontend-web.md

---

📦 Skills

🦀 backend-rust — Rust gRPC Backend

Full context of the Anachak Rust backend: modules, patterns, infra wiring, and RPCs.

Layer	Technology
Language	Rust 2021 edition
Transport	gRPC (Tonic 0.12) + gRPC-Web
Database	PostgreSQL via SQLx 0.8
Auth	JWT (Access + Refresh) + Argon2
Protocols	Protocol Buffers v3 (Buf CLI v2)
Payments	Bakong / KHQR (EMV-compliant)
Observability	Prometheus + optional OpenTelemetry
Real-time	WebSocket (tokio-tungstenite 0.24)
2FA	TOTP (Google Authenticator compatible)
IDs	ULID — sortable unique identifiers

Skill files:

File	Contents
SKILL.md	Module summary, entrypoints, ports, key patterns
folder-structure.md	Full workspace layout
module-anatomy.md	Repo → Service → types pattern
infrastructure.md	32 utility packages
interceptors.md	7-layer Tower chain + AuthInterceptor
database-patterns.md	SQLx patterns, migrations, transactions
error-handling.md	AppError → gRPC Status mapping
new-module-checklist.md	Step-by-step guide to add a module
proto-and-buf.md	Proto definitions and Buf CLI workflow

Key architectural patterns:

• 🔁 Repository-Service — types.rs → _repo.rs → _service.rs per module
• 🏗️ Arc-DI — All shared services wrapped in Arc<T>, passed explicitly
• 🔐 Tower layer chain — 7 cross-cutting layers (recovery, timeout, logging, etc.)
• 🛡️ AuthInterceptor — JWT + blacklist validation, user context injection
• 📅 Forward-only SQL migrations — Sequential .sql files
• 📡 EventBus — Decoupled domain event side-effects
• 🚦 Feature flags — PostgreSQL-backed with 60s in-memory refresh

---

⚛️ frontend-web — React SPA

Full context for the Anachak web frontend: routing, state, gRPC client, theming, and i18n.

Layer	Technology
Framework	React 19
Router	TanStack Router (file-based)
State	Zustand 5
Styling	Tailwind CSS v4 + CSS custom properties
gRPC Client	ConnectRPC (gRPC-Web)
UI Components	Radix UI + shadcn/ui v4
Animations	Framer Motion 12
Build	Vite 7
Package Manager	Bun

Skill files:

File	Contents
SKILL.md	Stack, entrypoints, ports, key patterns
folder-structure.md	Full web/ layout
routing.md	TanStack file-based routes + layouts
state-management.md	5 Zustand stores
grpc-client.md	ConnectRPC client setup, 12 service clients
theming.md	AppearancePanel + 50+ CSS vars
colors.md	12-preset OKLCH color system
i18n.md	Khmer/English with dotted key paths
components.md	56 shadcn/ui component patterns
svg-icons.md	HugeIcons + custom SVG system

Key architectural patterns:

• 🗂️ File-based routing — TanStack auto-generates routeTree.gen.ts
• 🏗️ Layout groups — _auth/ (login) and _app/ (dashboard)
• 🔴 OKLCH color system — 12 presets × 11-step scales
• 🌍 View Transitions API — Circular-reveal theme toggle
• 🔐 Auth flow — JWT rotation with auto-refresh, Google One Tap, 2FA

---

🚀 deployment — CI/CD & Infrastructure

Docker multi-stage builds, GitHub Actions CI, Cloud Run deployment, and Kubernetes manifests.

Topic	Detail
CI Jobs	check → test → docker (push to GHCR)
Image	rust:1.88-slim builder → debian:bookworm-slim runtime (~80 MB)
Registry	GitHub Container Registry (ghcr.io)
Target	Google Cloud Run (asia-southeast1)
Self-hosted	Kustomize K8s manifests

View deployment skill →

---

🐟 terminal-fish — Developer Environment

Fish shell aliases, PostgreSQL helpers, gRPC debugging commands, and dev workflow shortcuts.

cw                          # cargo watch (hot reload)
ship "feat: add billing"   # git add -A && commit && push
pg auth_users               # dump table as JSON
call '{}' auth.v1.AuthService/Login  # gRPC call

View terminal skill →

---

🔧 Workflows

Step-by-step guides for common development tasks, designed to be followed by an AI coding agent:

Workflow	Description
new-module.md	Add a new gRPC module end-to-end
new-endpoint.md	Add an RPC to an existing module
new-page.md	Create a new frontend route/page
db-migration.md	Write and run a database migration
proto-gen.md	Regenerate proto bindings
deploy.md	Deploy to Cloud Run
dev.md	Start the local dev environment
check.md	Run the full CI check suite locally

---

📐 Rules

Enforced coding standards for AI agents working on this codebase:

Rule	Scope
backend-rust.md	Rust patterns, naming, error handling, module structure
frontend-web.md	React patterns, component style, routing, state

---

🚀 Quick Start

Install a skill in Claude Code

# Add the backend-rust skill
claude skill add https://github.com/<your-username>/rust-skill/skills/backend-rust

# Or add all skills at once
claude skill add https://github.com/<your-username>/rust-skill/skills/backend-rust
claude skill add https://github.com/<your-username>/rust-skill/skills/frontend-web
claude skill add https://github.com/<your-username>/rust-skill/skills/deployment
claude skill add https://github.com/<your-username>/rust-skill/skills/terminal-fish

Install via OpenAI Codex CLI

codex skill add https://github.com/<your-username>/rust-skill/skills/backend-rust

Manual install

Clone the repo and reference the skill files locally in your agent configuration:

git clone https://github.com/<your-username>/rust-skill.git

---

📖 What is SKILL.md?

SKILL.md is an open standard for packaging AI agent skills — reusable knowledge files that instantly teach an LLM coding assistant the patterns, architecture, and conventions of your codebase.

Skills are:

• Portable → work with Claude Code, Codex CLI, and any compliant agent
• Composable → mix and match skill packages per project
• Version-controlled → live in your Git repo alongside your code

Learn more at skillsmp.com and the official SKILL.md spec.

---

📄 License

MIT © 2026

---

Built with ❤️ for the open SKILL.md ecosystem

skillsmp.com · agentskills.io · Claude Code Skills