该技能是 AI 指令配置文件本身的设计顾问，用于判断 AGENTS.md、CLAUDE.md、GEMINI.md 及 .claude/（skills、agents、commands、hooks、settings.json）写得好不好、结构是否合理，不负责这些文件与项目状态是否同步。
三种模式：①审查诊断，针对已有配置输出问题清单（文件:行、维度、症状、建议改法、优先级）、改写建议和结论等级；②起草，为新项目按“根文件精简+子目录就近”原则生成配置骨架，输出前先确认项目类型、目录结构、协作 AI 数量；③问答，回答格式与最佳实践问题。模式由 Agent 自动判定，拿不准时先询问用户。
六个诊断维度：长度预算（逐行做“删掉会不会变”检验）、规则可执行性（是否可验证，避免不可测的形容词）、分区路由（根文件与子目录职责划分）、重复与矛盾（去重、矛盾指令二选一）、入口一致性（多入口以 AGENTS.md 为真源，其余做指针）、时效（引用路径、命令是否仍存在，能用 ls/grep 验证的必须验证）。
关键约束：审查模式默认只读不改，只有客户明确要求“改/优化/执行”才落地编辑，且只改被诊断出问题的部分；不凭空发明命令或路径，命令须来自项目可验证来源或客户提供，验证不了则标注待确认；默认不推荐上马 agents+hooks+skills 全家桶，先判断项目是否需要。本技能不执行代码、不跑测试、不改业务逻辑，不读取账号或凭据。与 soia-dev-doc-sync 分工：后者负责跨文档状态对账，本技能只做配置文件设计质量的一次性诊断。安装命令：npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-agent-md-advisor -y。