Agent Md Advisor

AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践;也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作,除非目标是给 AI coding agent 提供项目上下文。

757 stars 102 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add chujianyun/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add chujianyun/skills --skill agent-md-advisor
Manual install
git clone --depth 1 https://github.com/chujianyun/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/agent-md-advisor ~/.claude/skills/agent-md-advisor

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Agent Markdown Advisor

帮助用户回答、审查、优化和创建 AI coding agent 指令文件,重点覆盖 `AGENTS.md` 与 `CLAUDE.md`。

## 设计模式

本 skill 主要采用:
- **Advisor**:回答格式、结构、放什么/不放什么等最佳实践问题
- **Reviewer**:诊断已有 `AGENTS.md` / `CLAUDE.md` 是否违反最佳实践
- **Generator**:根据项目和用户描述创建新的指令文件
- **Editor**:用户明确要求执行优化时,直接修改相关文件

## Gotchas

- 不要把 `AGENTS.md` / `CLAUDE.md` 写成项目百科、README 复制品或完整 API 文档
- 不要把 `AGENTS.md` / `CLAUDE.md` 写成人设说明书、口号墙或愿望清单;它应该像给资深工程师的技术简报
- 不要把 linter、formatter、类型检查器能确定执行的规则改写成大量自然语言
- 不要写实际密钥、token、生产连接串、客户数据或内部安全细节;只写密钥位置和访问方式
- 不要凭空发明命令;先看 `package.json`、`pyproject.toml`、`Makefile`、CI workflow、README 等可验证来源
- 不要默认建议复杂 `.claude/agents`、hooks、MCP、skills;先判断项目是否真的需要
- 如果用户只要求诊断,不要直接改文件;如果用户说“优化、重写、创建、执行”,可以落地修改
- 保持文件短而可执行:`AGENTS.md` 理想上 150 行以内,`CLAUDE.md` 优先压到 80-120 行,超过 200 行要强烈考虑拆分

## 工作模式

先判断用户需求属于哪一类:

1. **问答模式**:解释格式、章节、层级、AGENTS.md 和 CLAUDE.md 区别、最佳实践。
2. **诊断模式**:用户已有文件,希望指出问题、违反的实践和改进建议。
3. **优化模式**:用户明确要求修改、重写、压缩、整理或“执行优化”。
4. **创建模式**:用户还没有文件,或希望根据描述生成 `AGENTS.md` / `CLAUDE.md`。

## 使用流程

复制此清单并跟踪进度:

```text
处理进度:
- [ ] 步骤 1:识别模式和目标文件
- [ ] 步骤 2:读取必要参考资料
- [ ] 步骤 3:读取项目上下文或用户提供内容
- [ ] 步骤 4:给出诊断、方案或草稿
- [ ] 步骤 5:如用户要求落地,修改文件并验证
```

### Step 1: 识别模式和目标文件

优先判断目标:

- 跨工具、Codex、Copilot、Cursor、通用 AI coding agent:优先 `AGENTS.md`
- Claude Code 项目记忆、Claude 专属规则:优先 `CLAUDE.md`
- 每个项目都会重复的工作偏好:优先放 global/user 级配置
- 当前项目、技术栈、架构和命令:优先放 repo 内 `AGENTS.md` / `CLAUDE.md`
- 个人本地偏好:优先 `CLAUDE.local.md` 或用户级 memory,不要提交到团队共享文件
- Monorepo 或多技术栈:考虑根目录文件 + 子目录嵌套文件

如果用户没有指定文件名:
Read the full skill on GitHub

Details

Skill name
agent-md-advisor
Path
skills/agent-md-advisor/SKILL.md
Repo updated
14 November 2026

FAQ

What does the Agent Md Advisor skill do?

AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践;也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作,除非目标是给 AI coding agent 提供项目上下文。

How do I install the Agent Md Advisor skill?

Claude Code plugin: /plugin marketplace add chujianyun/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent Md Advisor popular?

It lives in chujianyun/skills, which has 757 GitHub stars and 102 forks.

Related skills

Add Photo Certificate Watermarks

757

chujianyun/skills

为照片、身份证、护照、学位证、毕业证、资格证、营业执照等证件或证书扫描件及 PDF 添加本地文字水印。用户提出照片加版权水印、身份证或学历证件添加“仅限某用途”水印、资质文件批量加水印、生成水印预览,或需要保持头像、二维码、印章等区域可辨认时使用。支持 JPEG、PNG、WebP 和 PDF,默认先预览、保留原件并清除图片元数据。不用于去除水印、伪造或篡改证件内容,也不用于仅设计 Logo 水印素材。

Images, Video & Audio102

Agent Optimizer

757

chujianyun/skills

Agent 设计顾问与审查工具。基于 12-Factor AgentOps 最佳实践,用于:(1) 探讨 Agent 架构设计方案;(2) 审查现有 Agent/Skill/工作流的设计,发现问题,给出改进建议。触发词:审查我的 agent、帮我分析这个 skill、agent 设计、agent 优化、帮我 review 这个工作流、这个 agent 有什么问题、怎么设计 agent、agent 架构咨询。

AI, LLMs & Agents102

Alltuu Downloader

757

chujianyun/skills

喔图(alltuu.com)云摄影相册批量下载工具。当用户需要从 alltuu.com / m.alltuu.com 相册批量下载原图时使用此技能。支持下载原图(6720x4480 级别),自动处理签名URL,并发下载。适用于 alltuu.com/album/ 相册链接。

Other102

MCP Builder

617

LeastBit/Claude_skills_zh-CN

构建高质量 MCP(模型上下文协议)服务器的指南,使 LLM 能够通过精心设计的工具与外部服务交互。在使用 Python (FastMCP) 或 Node/TypeScript (MCP SDK) 构建 MCP 服务器以集成外部 API 或服务时使用。

AI, LLMs & Agents96

Baize

757

chujianyun/skills

将公开或用户有权访问的 Wiki 完整转换为面向 Agent 的离线知识 Skill,并按原 Wiki 层级保存 Markdown、生成检索索引和逐文档哈希清单,支持无变化不落盘的手动或自动增量更新。当用户要求把 Wiki、文档站或帮助中心做成 Skill、同步已有 Wiki Skill、保持文档目录树或设置 Wiki Skill 自动更新时使用;不用于只摘要单篇网页或绕过登录、付费墙和访问控制。

AI, LLMs & Agents102

Internal Comms

617

LeastBit/Claude_skills_zh-CN

一套帮助我撰写各类内部沟通文档的资源,使用公司偏好的格式。当被要求撰写任何形式的内部沟通文档(状态报告、领导层更新、3P 更新、公司简报、常见问题解答、事件报告、项目更新等)时,Claude 应使用此技能。

AI, LLMs & Agents96

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.