diff --git a/.codex/skills b/.codex/skills
new file mode 120000
index 000000000..01b309374
--- /dev/null
+++ b/.codex/skills
@@ -0,0 +1 @@
+../.trae/skills
\ No newline at end of file
diff --git a/AGENTS.md b/AGENTS.md
index 888074ed8..8f9a931e0 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -162,6 +162,24 @@ Certd 是一个支持私有化部署的 SSL/TLS 证书自动化管理平台。
 - `packages/ui/certd-server/data/`、`logs/`、生成的 metadata/dist 等通常视为运行时或构建产物，除非任务明确要求处理它们。
 - 注意本地数据和配置里可能包含凭据、证书材料等敏感信息。
 
+## 插件开发技能
+
+仓库内置了 Certd 插件开发技能，供 Trae 和 Codex 共用：
+
+- Trae 入口：`.trae/skills`
+- Codex 入口：`.codex/skills`
+
+其中 `.codex/skills` 是指向 `.trae/skills` 的目录链接，不要复制出第二份技能内容。更新技能时只维护 `.trae/skills` 下的原始文件，Codex 会通过 `.codex/skills` 读取同一份内容。
+
+当前技能包括：
+
+- `access-plugin-dev`：开发 Access 授权插件
+- `dns-provider-dev`：开发 DNS Provider 插件
+- `task-plugin-dev`：开发 Task 部署任务插件
+- `plugin-converter`：将插件转换为 YAML 配置
+
+做插件相关任务时，先读取对应技能目录下的 `SKILL.md`，再进入具体实现。若用户在插件开发中指出更好的做法，应总结并更新对应技能。
+
 ## 快速定向命令
 
 进入项目后，优先使用这些有目标的读取命令，而不是立刻全仓库扫描：