AgentSkillsCN

skills-consolidation-architect

将各仓库专属的技能整合为模块化、可复用的集合。在审计技能重叠情况、拆分单体技能、精简一次性技能、界定各仓库的核心技能与进阶技能，以及规划安全的弃用策略并辅以锁定准入测试时，此方法尤为适用。

SKILL.md
--- frontmatter
name: skills-consolidation-architect
description: Consolidate repository-specific skills into modular, reusable sets. Use when auditing skill overlap, splitting monolithic skills, reducing one-shot skills, defining per-repo core vs advanced skills, and planning safe deprecations with lockdown admission tests.

Skills Consolidation Architect

Use this skill to keep your skill ecosystem modular and maintainable.

Consolidation Workflow

  1. •Inventory installed skills and group by repository domain.
  2. •Optionally ingest recent cross-repo radar results from $skills-cross-repo-radar.
  3. •Run overlap audit and identify merge/split candidates.
  4. •Apply consolidation rubric:
    • •keep single-responsibility skills,
    • •split multi-workflow monoliths,
    • •avoid near-duplicate trigger scopes.
  5. •Define per-repo sets:
    • •core: always-on, high-frequency tasks,
    • •advanced: specialized workflows,
    • •experimental: new candidates pending arbiter evidence.
  6. •Admit changed/new skills with skill-arbiter --personal-lockdown.

Commands

Inventory installed skills:

bash
find $CODEX_HOME/skills -mindepth 1 -maxdepth 1 -type d -printf '%f\n' | sort

Run overlap audit:

bash
python3 scripts/skill_overlap_audit.py --skills-root $CODEX_HOME/skills --threshold 0.28

JSON output for automation:

bash
python3 scripts/skill_overlap_audit.py \
  --skills-root $CODEX_HOME/skills \
  --threshold 0.28 \
  --json-out /tmp/skill-overlap.json

Admit consolidated candidates safely:

bash
python3 "$CODEX_HOME/skills/skill-arbiter/scripts/arbitrate_skills.py" <skill> [<skill> ...] \
  --source-dir "$CODEX_HOME/skills" \
  --window 10 --threshold 3 --max-rg 3 \
  --personal-lockdown

Decision Rules

  • •score >= 0.55: likely duplicate; merge or retire one.
  • •0.35 <= score < 0.55: boundary blur; tighten descriptions/scope.
  • •score < 0.35: generally distinct.

Keep each repo’s core set between 3 and 6 skills by default.

References

  • •references/consolidation-rubric.md
  • •scripts/skill_overlap_audit.py