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。