Community寫作與編輯github.com

iosrxwy/skillint

AI 代理技能靜態分析工具。稽核由 Codex、Cursor 和 Claude Code 使用的 SKILL.md 與 AGENTS.md。

skillint 是什麼?

skillint 是一套靜態分析工具,專為管理與優化 AI 代理(例如 Codex、Cursor、Claude Code)的技能而設計。它能掃描、稽核、報告並修復技能設定檔(SKILL.md、AGENTS.md),幫助開發者控制技能數量與品質,避免因過多技能拖慢代理效能。支援跨代理庫存掃描、單一代理目錄對應、權杖用量估算、重複名稱偵測、隔離式清理(trash/quarantine)及符號連結共享。提供完整的 CLI 指令集,並可整合至 CI 流程。

相容平台✓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。請稱之為估算,而非精確的 tokenizer 計數。
  • 掃描後應摘要:技能數量、健康分數、中繼資料權杖數、完整主體權杖數、始終啟用規則權杖數。
  • 當使用者想跳過廠商副本時,提醒使用 .skillintignore 與 --ignore 參數。
  • 在 CI 環境中,建議使用 uses: iosrxwy/skillint@main 或 node dist/cli.js doctor --fail-on error。

相關技能