阿格尼克斯
- 作者仓库星标 264
- 作者仓库 agnix
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @agent-sh · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful' [fixable]
help: Remove generic instructions. Claude already knows this.
skills/review/SKILL.md:3:1 error: Invalid name [fixable]
help: Use lowercase letters and hyphens only
Found 1 error, 1 warning (2 fixable)
# agnix
Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across Claude Code, Cursor, GitHub Copilot, and Codex CLI.
## When to Use
Invoke when user asks to:
- "Lint my agent configs"
- "Validate my skills"
- "Check my CLAUDE.md"
- "Validate hooks"
- "Lint MCP configs"
- "Fix agent configuration issues"
## Supported Files
| File Type | Examples |
|-----------|----------|
| Skills | `SKILL.md` |
| Memory | `CLAUDE.md`, `AGENTS.md` |
| Hooks | `.claude/settings.json` |
| MCP | `*.mcp.json` |
| Cursor | `.cursor/rules/*.mdc` |
| Copilot | `.github/copilot-instructions.md` |
## Execution
### 1. Check if agnix is installed
```bash
agnix --version
```
If not found, install:
```bash
cargo install agnix-cli
```
### 2. Validate
```bash
agnix .
```
### 3. If issues found and --fix requested
```bash
agnix --fix .
```
### 4. Re-validate to confirm
```bash
agnix .
```
## CLI Reference
| Command | Description |
|---------|-------------|
| `agnix .` | Validate current project |
| `agnix --fix .` | Auto-fix issues |
| `agnix --strict .` | Treat warnings as errors |
| `agnix --target claude-code .` | Only Claude Code rules |
| `agnix --target cursor .` | Only Cursor rules |
| `agnix --watch .` | Watch mode |
| `agnix --format json .` | JSON output |
## Output Format
```
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful' [fixable]
help: Remove generic instructions. Claude already knows this.
skills/review/SKILL.md:3:1 error: Invalid name [fixable]
help: Use lowercase letters and hyphens only
Found 1 error, 1 warning (2 fixable)
```
## Common Issues & Fixes
| Issue | Solution |
|-------|----------|
| Invalid skill name | Use lowercase with hyphens: `my-skill` |
| Generic instructions | Remove "be helpful", "be accurate" |
| Missing trigger phrase | Add "Use when..." to description |
| Directory/name mismatch | Rename directory to match `name:` field |
## Links
- [GitHub](https://github.com/agent-sh/agnix)
- [Rules Reference](https://avifenesh.github.io/agnix/docs/rules)
章节与文件索引
按说明文件中的顺序排列。
何时使用
支持的文件
1.检查是否安装了agnix
CLI 参考
常见问题和修复
文件/命令 -> CLAUDE.md · AGENTS.md · .claude/settings.json · *.mcp.json · .cursor/rules/*.mdc · .github/copilot-instructions.md · agnix . · agnix --fix .
内容校验值 -> 58447c42a84c
当前原文的自动摘译,尚未人工审校。
何时使用
当用户要求:“检查我的代理配置”“验证我的技能”“检查我的 CLAUDE.md”“验证挂钩”时调用
支持的文件
文件类型 · 示例技能 ·
SKILL.md内存 ·CLAUDE.md、AGENTS.md钩子 ·.claude/settings.jsonMCP ·*.mcp.json1.检查是否安装了agnix
如果没有找到,请安装:
CLI 参考
命令 · 描述
agnix .· 验证当前项目agnix --fix .· 自动修复问题agnix --strict .· 将警告视为错误agnix --target claude-code .· 仅 Claude Code 规则常见问题和修复
问题 · 解决方案 无效的技能名称 · 使用小写字母和连字符:
my-skill通用说明 · 删除“有帮助”、“准确” 缺少触发短语 · 在描述中添加“使用...” 目录/名称不匹配 · 重命名目录以匹配name:字段