Phase 2B Skills Audit — Complete Inventory (All 16 Agents, 377 Skills) #1305

Audit Summary

Complete Phase A (Audit & Evaluation) of the Phase 2B Skills Architecture initiative. Audited all 16 agents (377 total skills) with comprehensive skill inventory, conflict identification, and consolidation strategy.

Audit Checklist / Scope

• Scope defined and agreed — 16 agents, all skill categories
• Areas/components listed — Complete agent skills directories
• Audit tools or standards referenced — Agent SKILL.md specs, skill categorisation framework
• Risks and findings documented — Conflict matrix with HIGH/MEDIUM/LOW severity
• Remediation actions mapped — Phase B planning framework established

Findings / Risks

Skills Inventory (377 Total)

• Batch 1 (5 agents): 125 skills ✅
• Batch 2-3 (11 agents): 252 skills ✅

High-Severity Conflicts

1. Figma Integration — Root versions (2023-09) outdated; agent versions current (2026-07)
2. PRD Agent Duplication — prd-agent & prd-factory-planner-agent significant overlap
3. WordPress Config — WooCommerce vs core WordPress specialisation required

Consolidation Opportunities

• CRITICAL: 11 agents use 'documents', 8 use 'reports', 5 use 'export-tools'
• HIGH: figma (4 agents with conflicts), templates (3 agents)
• MEDIUM: 65 local utilities → potential Tier 0 consolidation (~20 shared skills)

Remediation Actions

Phase B (Planning & Architecture) — Weeks 3-4

• Create skill dependency map
• Design override system architecture
• Document governance rules for Tier 0/1 consolidation
• Plan per-agent consolidation roadmap with effort estimates

Phase C (Implementation) — Weeks 5-12

• Consolidate Tier 0 utilities to root (establish single source of truth)
• Implement Tier 1 override system with agent customisation support
• Archive or integrate Tier 2-3 skills
• Update all 16 agents to reference consolidated skills

Acceptance Criteria

• Audit scope and checklist completed
• Findings and risks documented with severity levels
• Remediation actions assigned and tracked
• Documentation and audit reports complete
• PR uses correct branch prefix (audit/)

Additional Context

Related Issues:

• Phase 2B Agent Skills Architecture Audit & Consolidation Plan #1225 — Phase 2B Skills Audit (primary tracking issue)
• Epic: Multi-Provider Agent Standardization Initiative #1079 — Epic: Agent Standardisation Initiative

Deliverables:

• AGENT_SKILLS_INVENTORY.md — Complete catalog of all 16 agents
• PHASE-2B-SKILLS-AUDIT.md — Comprehensive audit report with conflict analysis
• SKILLS_POPULARITY_MATRIX.csv — Consolidation candidates identified

PR #1283 — Merged to develop with all 9 agents with placeholder skills expanded

Definition of Ready (DoR)

• Audit scope, checklist, and goals defined
• Areas/components (16 agents) listed
• Dependencies and standards mapped (skill framework)

Definition of Done (DoD)

• Audit performed and findings documented
• Remediation actions assigned (Phase B/C tasks)
• Documentation complete and linted
• PR uses correct branch prefix (audit/)

Status: Phase A Complete ✅
Date Completed: 2026-07-24
Next Phase: Phase B — Inventory & Planning