Skill Lifecycle

Skill Lifecycle

A useful skill environment needs maintenance. Too many stale, overlapping, or noisy skills reduce agent quality.

Audit

Audit installed skills for Codex:

python scripts/audit_skills.py audit --dest "$HOME/.agents/skills"

Audit installed skills for Claude Code:

python scripts/audit_skills.py audit --dest "$HOME/.claude/skills"

Disable

Disable a noisy or unused skill without deleting it:

python scripts/audit_skills.py disable <skill-name> --dest "$HOME/.agents/skills"

Quarantine

Quarantine suspicious skills:

python scripts/audit_skills.py quarantine <skill-name> --dest "$HOME/.agents/skills"

Restore

Restore a disabled skill:

python scripts/audit_skills.py restore <skill-name> --dest "$HOME/.agents/skills"

Prune

Dry-run first:

python scripts/audit_skills.py prune --older-than-days 180 --dry-run --dest "$HOME/.agents/skills"

Then prune only when the removal set is clearly correct.

Mis-Invocation Prevention

Review each skill's description.

Good descriptions:

• name specific trigger words;
• define a narrow scope;
• explain boundaries.

Risky descriptions:

• "use for all tasks";
• "always run";
• "do everything";
• broad wording that overlaps with many workflows.

If a skill is useful but too broad, narrow its description. If two skills overlap, prefer one and disable the weaker one.

中文说明

Skill 环境需要维护。太多过期、重叠或触发过宽的 skill 会降低 agent 质量。

常见维护动作：

动作	用途
Audit	检查已安装 skill 的结构、描述、风险和重复。
Disable	暂时禁用噪音大或不常用的 skill。
Quarantine	隔离可疑 skill。
Restore	恢复之前禁用的 skill。
Prune	清理长期不用的 skill，先 dry-run。

重点检查 description。好的描述应该有明确触发词、窄范围和边界；风险描述通常写着“use for all tasks”、“always run”、“do everything”。

如果两个 skill 重叠，保留更精确、更安全、更常用的那个。