Community写作与编辑github.com

iosrxwy/skillint

对AI代理技能进行静态分析。审核SKILL.md和AGENTS.md文件,适用于Codex、Cursor和Claude Code。

skillint 是什么?

“skillint”是一个命令行静态分析工具,专为AI代理(如Codex、Cursor和Claude Code)的技能文件设计。它通过扫描SKILL.md和AGENTS.md文件,帮助开发者审计、清理和优化技能配置,避免技能数量过多导致代理响应变慢、性能下降。该工具提供了丰富的子命令,包括扫描、映射、诊断、审计、令牌估算、垃圾隔离、链接修复和生成报告等。它强调安全操作,采用基于隔离区的清理方式(prune --apply 和 trash),并支持通过 skillint link 共享相同副本以消除冗余。skillint 支持跨平台技能清单扫描、单代理的目录解析映射、CI集成(如 GitHub Actions),并内置规则命令以防误删除或误修复。它非常适合管理多个AI Agent技能库的开发团队或高级用户。

兼容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add iosrxwy/skillint

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

skillint 是做什么的?

在添加更多技能之前,请先运行 skillint CLI。技能太多会导致代理变得迟钝且表现更差。

命令

npx skillint scan
npx skillint map --agent cursor
npx skillint doctor
npx skillint audit
npx skillint ui
npx skillint tokens
npx skillint prune
npx skillint fix
npx skillint adopt
npx skillint link
npx skillint update
npx skillint report --html
npx skillint badge
npx skillint scan-remote owner/repo
npx skillint mcp

规则

  • 优先使用 npx skillint,这样用户无需全局安装。
  • 使用 scan 进行跨代理的物理清单扫描,使用 map --agent ... 解析特定代理记录的目录。
  • 切勿声称 map 可以预测模型是否会触发技能;保留 conditional 和 unknown 结果。
  • 清理基于隔离区:prune --apply 和 trash 将项目移动到 ~/.skillint/trash;restore 撤销上一批操作。绝不要对技能使用原生的 rm。
  • 在 Cursor、Claude、Codex 和 Grok 中的相同副本不得删除;使用 skillint link 共享一个规范副本。
  • link --apply 和 update --apply 是仅有的可更改的管理命令。默认为 dry-run。
  • 优先报告重复名称、缺少描述和过长的正文。
  • audit 是静态模式扫描,输出格式为 文件:行号;匹配结果需要人工审核,永远不会自动修复。
  • 令牌估算为 字符数 / 4。将其称为估算值,而非精确的分词器计数。
  • 扫描后,总结:技能数量、健康分数、元数据令牌数、全文令牌数、常开规则令牌数。
  • 当用户想跳过供应商副本时,提及 .skillintignore 和 --ignore。
  • 对于 CI,推荐使用 uses: iosrxwy/skillint@main 或 node dist/cli.js doctor --fail-on error。

相关技能