AI Expert Skills / AI 专家技能库

Repository: https://github.com/Miaoge-Ge/coding-agent-skills

English | 中文

# Quick start in Claude Code
/plugin marketplace add Miaoge-Ge/coding-agent-skills
/plugin install cpp-expert@ai-expert-skills

🇬🇧 English

A curated collection of refined skill definitions that turn your AI coding assistant into a domain-specific expert. Distributed as Claude Code plugins through a built-in plugin marketplace, and also usable as plain skills in Open Code, Cursor, and Trae.

Each skill provides structured, high-quality context — when to engage, when not to, concrete guidance, and runnable examples — so your assistant behaves like a focused expert instead of a generalist.

Repository Layout

coding-agent-skills/
├── .claude-plugin/
│   └── marketplace.json          # marketplace catalog (lists all plugins)
├── plugins/
│   ├── competitive-programming-expert/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/competitive-programming-expert/SKILL.md
│   ├── cpp-expert/ …
│   ├── python-expert/ …
│   ├── deep-learning-expert/ …
│   ├── llm-testing-expert/ …
│   ├── software-architect/ …
│   ├── github-master/ …
│   └── threejs/                  # bundles all 10 Three.js skills
│       └── skills/threejs-*/SKILL.md
└── rules/                        # Cursor-style coding-standard rules (not a plugin)

Each plugin is a self-contained directory with a .claude-plugin/plugin.json manifest; its skills live in skills/<slug>/SKILL.md. The marketplace name is ai-expert-skills.

Plugins Included

28 plugins (37 skills) in the ai-expert-skills marketplace, grouped by category.

Languages

Plugin	Description
typescript-expert	TypeScript type system, generics, narrowing, and strict-mode safety.
python-expert	Pythonic code, typing, async, standard-library usage, performance.
cpp-expert	Modern C++ (17/20/23), memory safety, RAII, move semantics, performance.
rust-expert	Ownership, lifetimes, traits, async, and idiomatic error handling.
go-expert	Idiomatic Go: goroutines, channels, interfaces, error handling.

Frontend

Plugin	Description
react-expert	Modern React (18/19): hooks, patterns, state, performance, Server Components.
nextjs-expert	Next.js App Router, Server Components, server actions, caching.
tailwind-expert	Tailwind CSS utility-first styling, responsive design, theming.
accessibility-expert	Web a11y: WCAG, semantic HTML, ARIA, keyboard, screen readers.
threejs (10 skills)	Full Three.js set: fundamentals, geometry, materials, lighting, textures, animation, loaders, shaders, post-processing, interaction.

Backend & Data

Plugin	Description
nodejs-backend-expert	Node.js services (Express/Fastify/Hono): routing, middleware, auth, async.
api-design-expert	REST/GraphQL design: resources, versioning, pagination, errors, contracts.
sql-expert	SQL queries, schema design, indexing, query optimization, transactions.

AI / LLM

Plugin	Description
prompt-engineering-expert	Prompt structure, few-shot, chain-of-thought, output formatting.
rag-expert	Chunking, embeddings, vector/hybrid search, reranking, grounding.
llm-testing-expert	Evaluation strategies, prompt engineering, red teaming, regression testing.
deep-learning-expert	Model architecture, training strategies, debugging, paper interpretation.

DevOps

Plugin	Description
docker-expert	Dockerfiles, multi-stage builds, image optimization, Compose.
kubernetes-expert	Workloads, Services, ConfigMaps, probes, resources, troubleshooting.
bash-scripting-expert	Robust, safe shell scripts: quoting, error handling, POSIX patterns.
github-master	Git workflows, repo management, PRs, GitHub Actions CI/CD.

Quality & Craft

Plugin	Description
testing-expert	Unit/integration/e2e, TDD, mocking, fixtures, coverage.
debugging-expert	Systematic root-cause analysis: reproduce, bisect, fix the cause.
refactoring-expert	Safe, incremental, behavior-preserving cleanup and tech-debt paydown.
performance-expert	Profiling and optimizing CPU/memory/I/O/rendering, measure-first.
security-expert	Secure coding & review (OWASP Top 10), authn/authz, secrets.
software-architect	System design, technology selection, trade-off analysis.
competitive-programming-expert	Algorithmic problem solving, complexity analysis, optimization.

Install via Claude Code (recommended)

Add the marketplace once, then install any plugin from it.

# 1. Register the marketplace (from the GitHub repo)
/plugin marketplace add Miaoge-Ge/coding-agent-skills

# 2. Install the plugins you want
/plugin install cpp-expert@ai-expert-skills
/plugin install threejs@ai-expert-skills
/plugin install software-architect@ai-expert-skills

# Or browse and install interactively
/plugin

Equivalent non-interactive CLI:

claude plugin marketplace add Miaoge-Ge/coding-agent-skills
claude plugin install cpp-expert@ai-expert-skills

Update later with /plugin marketplace update ai-expert-skills. Manage installs in the /plugin menu.

Local development: from a clone of this repo you can register the marketplace by path — claude plugin marketplace add ./ — then claude plugin install <name>@ai-expert-skills.

Use without the plugin system

The skills are plain SKILL.md files, so you can also copy them directly:

• Claude Code / Open Code: copy plugins/<plugin>/skills/<slug>/ into .claude/skills/ (project) or ~/.claude/skills/ (global).
• Cursor: copy into .cursor/skills/.
• Trae: copy into .trae/skills/.

For the Three.js bundle, copy the individual skill folders under plugins/threejs/skills/.

Coding-Standard Rules

rules/ holds Cursor-style rules that auto-attach by file glob (they are not part of the Claude Code plugins):

Rule	Scope	File
cpp-style-guide	*.cpp,*.hpp,*.h,*.cc,*.cxx	View
python-style-guide	*.py,*.pyi	View

Place them where your editor expects rule files (e.g., Cursor's .cursor/rules/).

How It Works

Once a plugin is installed, Claude Code auto-discovers its skills and engages the right one based on each skill's description. Example triggers:

• Create a 3D scene → threejs (fundamentals)
• Add lighting and shadows → threejs (lighting)
• Load a GLTF model → threejs (loaders + animation)
• Solve a contest problem → competitive-programming-expert
• Design a distributed system → software-architect

Skill File Structure

Each SKILL.md uses YAML frontmatter plus Markdown:

---
name: skill-slug          # [a-z0-9-]+, matches its directory name
description: "When to engage, with trigger keywords. Quoted when it contains a colon."
---

The body of a general skill follows a consistent layout:

# Skill Title

## Role / Description    # who the expert is
## When to Use           # concrete activation triggers
## When NOT to Use       # boundaries + which skill to defer to
## Guidelines            # the actual expertise
## Examples              # runnable code / patterns
## See Also              # cross-references to related skills

Workflow-heavy skills (software-architect, deep-learning-expert, llm-testing-expert, competitive-programming-expert) additionally include Input/Output contracts, step-by-step Execution Steps, and Failure Handling. The Three.js skills are example-driven, leading with a runnable quick start.

License

MIT — see LICENSE.

---

🇨🇳 中文

一套精心打磨的技能定义，可将你的 AI 编程助手变成特定领域的专家。以 Claude Code 插件形式通过内置插件市场分发，同时也能作为普通技能用于 Open Code、Cursor、Trae。

每个技能都提供结构化、高质量的上下文——何时启用、何时不启用、具体指导以及可运行示例——让助手表现得像一位聚焦的专家，而不是泛泛而谈。

仓库结构

coding-agent-skills/
├── .claude-plugin/
│   └── marketplace.json          # 市场目录（列出全部插件）
├── plugins/
│   ├── competitive-programming-expert/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/competitive-programming-expert/SKILL.md
│   ├── cpp-expert/ …
│   ├── python-expert/ …
│   ├── deep-learning-expert/ …
│   ├── llm-testing-expert/ …
│   ├── software-architect/ …
│   ├── github-master/ …
│   └── threejs/                  # 打包全部 10 个 Three.js 技能
│       └── skills/threejs-*/SKILL.md
└── rules/                        # Cursor 风格代码规范（不属于插件）

每个插件都是独立目录，含 .claude-plugin/plugin.json 清单；其技能位于 skills/<slug>/SKILL.md。市场名称为 ai-expert-skills。

包含的插件

ai-expert-skills 市场共 28 个插件(37 个技能),按品类分组。

编程语言

插件	描述
typescript-expert	TypeScript 类型系统、泛型、类型收窄与严格模式安全。
python-expert	Pythonic 代码、类型标注、异步、标准库与性能优化。
cpp-expert	现代 C++（17/20/23）、内存安全、RAII、移动语义、性能调优。
rust-expert	所有权、生命周期、trait、异步与地道的错误处理。
go-expert	地道 Go：goroutine、channel、接口与错误处理。

前端

插件	描述
react-expert	现代 React（18/19）：hooks、模式、状态、性能、Server Components。
nextjs-expert	Next.js App Router、Server Components、server actions、缓存。
tailwind-expert	Tailwind CSS 工具类样式、响应式、主题与设计系统。
accessibility-expert	Web 无障碍：WCAG、语义化 HTML、ARIA、键盘与读屏。
threejs (10 个技能)	完整 Three.js 套件：基础、几何体、材质、灯光、纹理、动画、加载器、着色器、后处理、交互。

后端与数据

插件	描述
nodejs-backend-expert	Node.js 服务（Express/Fastify/Hono）：路由、中间件、鉴权、异步。
api-design-expert	REST/GraphQL 设计：资源建模、版本化、分页、错误、契约。
sql-expert	SQL 查询、表结构设计、索引、查询优化与事务。

AI / 大模型

插件	描述
prompt-engineering-expert	提示词结构、few-shot、思维链、输出格式化。
rag-expert	分块、embedding、向量/混合检索、重排序与答案接地。
llm-testing-expert	评测策略、提示词工程、红队测试与回归测试。
deep-learning-expert	模型架构设计、训练策略、调试与论文解读。

DevOps

插件	描述
docker-expert	Dockerfile、多阶段构建、镜像优化、Compose。
kubernetes-expert	工作负载、Service、ConfigMap、探针、资源与排障。
bash-scripting-expert	健壮安全的 shell 脚本:引号、错误处理、POSIX 模式。
github-master	Git 工作流、仓库管理、PR 与 GitHub Actions CI/CD。

质量与工程素养

插件	描述
testing-expert	单元/集成/端到端、TDD、mock、fixture、覆盖率。
debugging-expert	系统化根因分析:复现、二分定位、修因不修表。
refactoring-expert	安全、增量、保持行为的重构与技术债清理。
performance-expert	CPU/内存/IO/渲染性能剖析与优化,先测量后优化。
security-expert	安全编码与审查(OWASP Top 10)、鉴权、密钥。
software-architect	系统设计、技术选型与架构权衡分析。
competitive-programming-expert	算法解题、复杂度分析与优化。

通过 Claude Code 安装（推荐）

只需添加一次市场，之后即可按需安装其中的插件。

# 1. 注册市场（从 GitHub 仓库）
/plugin marketplace add Miaoge-Ge/coding-agent-skills

# 2. 安装你需要的插件
/plugin install cpp-expert@ai-expert-skills
/plugin install threejs@ai-expert-skills
/plugin install software-architect@ai-expert-skills

# 或交互式浏览安装
/plugin

等价的非交互式 CLI：

claude plugin marketplace add Miaoge-Ge/coding-agent-skills
claude plugin install cpp-expert@ai-expert-skills

之后用 /plugin marketplace update ai-expert-skills 更新；在 /plugin 菜单中管理已安装插件。

本地开发： 在本仓库的克隆中可用路径注册市场——claude plugin marketplace add ./——再执行 claude plugin install <name>@ai-expert-skills。

不使用插件系统时

技能本质上就是 SKILL.md 文件，也可以直接复制使用：

• Claude Code / Open Code： 将 plugins/<plugin>/skills/<slug>/ 复制到 .claude/skills/（项目级）或 ~/.claude/skills/（全局）。
• Cursor： 复制到 .cursor/skills/。
• Trae： 复制到 .trae/skills/。

对于 Three.js 套件，复制 plugins/threejs/skills/ 下的各技能文件夹即可。

代码规范规则

rules/ 存放 Cursor 风格规则，按文件 glob 自动挂载（不属于 Claude Code 插件）：

规则	适用范围	文件
cpp-style-guide	*.cpp,*.hpp,*.h,*.cc,*.cxx	查看
python-style-guide	*.py,*.pyi	查看

将其放到编辑器期望的规则目录（例如 Cursor 的 .cursor/rules/）。

工作原理

插件安装后，Claude Code 会自动发现其技能，并根据每个技能的 description 启用最匹配的那个。常见触发示例：

• 搭建 3D 场景 → threejs（基础）
• 添加灯光与阴影 → threejs（灯光）
• 加载 GLTF 模型 → threejs（加载器 + 动画）
• 解算法竞赛题 → competitive-programming-expert
• 设计分布式系统 → software-architect

技能文件结构

每个 SKILL.md 由 YAML frontmatter 加 Markdown 正文组成：

---
name: skill-slug          # [a-z0-9-]+，与目录名一致
description: "何时启用，含触发关键词；含冒号时需加引号。"
---

通用技能正文采用统一布局：

# 技能标题

## Role / Description    # 该专家是谁
## When to Use           # 具体触发条件
## When NOT to Use       # 边界，以及应转交哪个技能
## Guidelines            # 核心专业知识
## Examples              # 可运行代码 / 模式
## See Also              # 关联技能交叉引用

工作流型技能（software-architect、deep-learning-expert、llm-testing-expert、competitive-programming-expert）还包含 Input/Output 契约、分步 Execution Steps 与 Failure Handling。Three.js 系列以示例驱动，以可运行的快速上手开头。

许可证

MIT —— 见 LICENSE。