skill-candidates/skills-consolidation-architect/SKILL.md
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.
npx skillsauth add grtninja/skill-arbiter skills-consolidation-architectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill to keep your skill ecosystem modular and maintainable.
$skill-auditor first for recent-change quality signals plus per-skill unique vs upgrade classification.$skills-cross-repo-radar.$usage-watcher, $skill-cost-credit-governor, and $skill-cold-start-warm-path-optimizer; capture usage guardrail evidence before finalizing chain recommendations.core: always-on, high-frequency tasks,advanced: specialized workflows,experimental: new candidates pending arbiter evidence.core set includes explicit usage guardrail consideration and documented disposition for usage-watcher, skill-cost-credit-governor, and skill-cold-start-warm-path-optimizer.skill-arbiter --personal-lockdown.pass.Inventory installed skills:
find $CODEX_HOME/skills -mindepth 1 -maxdepth 1 -type d -printf '%f\n' | sort
Run overlap audit:
python3 scripts/skill_overlap_audit.py --skills-root $CODEX_HOME/skills --threshold 0.28
JSON output for automation:
python3 scripts/skill_overlap_audit.py \
--skills-root $CODEX_HOME/skills \
--threshold 0.28 \
--json-out /tmp/skill-overlap.json
Admit consolidated candidates safely:
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
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.
Use this skill only for the skills-consolidation-architect lane and workflow defined in this file and its references.
Do not use this skill for unrelated lanes; route those through $skill-hub and the most specific matching skill.
references/consolidation-rubric.mdscripts/skill_overlap_audit.pyIf this lane is unresolved, blocked, or ambiguous:
$skill-hub for chain recalculation.tools
Run a defender-first security sweep on code, configs, prompts, model/tooling surfaces, or third-party contribution lanes. Use when a request involves safe bug, leak, zero-day-class, exploit, or hack hunting for protection, when contributing to outside repositories and you want a focused security pass, or when touching auth, secrets, permissions, network exposure, prompt/tool boundaries, data flow, or update/build surfaces. This skill is defensive only and must never be used for weaponization or unauthorized access.
development
Validate and repair VRM Sandbox startup acceptance with shim-first local model authority, frontend/backend bring-up, and avatar-runtime launch proof. Use when launch behavior, chat handoff, voice fallback, or runtime bridge acceptance must be verified end to end.
documentation
Align documented voice-command catalogs, endpoint action allowances, and live runtime handlers so operator-visible voice surfaces match what the stack can actually execute. Use when voice command docs, parser matrices, endpoint permissions, or runtime action routing drift apart.
development
Track SkillHub trend and topic drift, maintain a bounded rewrite watchlist, and surface emerging gaps worth turning into repo-owned skills. Use when the marketplace query set shows new families or when the current shortlist has gone stale.