Skip to content

Phase 2B Skills Architecture Audit (Comprehensive Skill Analysis) #1259

New issue
New issue
Open
Task
#1315
Open
Phase 2B Skills Architecture Audit (Comprehensive Skill Analysis)#1259
Task
#1315
Assignees
ashleyshaw
Labels
priority:normalstatus:needs-triagetype:audit
Milestone
v1.1

Description

@ashleyshaw
ashleyshaw
opened on Jul 24, 2026

Overview

Comprehensive audit of agent skills architecture across 16 agents to establish clear taxonomy, resolve version conflicts, and create consolidation roadmap.

Project Folder

📁 projects/active/phase-2b-skills-audit

See README.md and IMPLEMENTATION_NOTES.md for complete details.

What This Addresses

Problem: 16 agents with 368 skill directories (123 root skills) — unclear ownership, duplicate implementations, version conflicts

Goal: Establish shared vs. agent-specific skill framework enabling scalable agent development

Current Progress (Phase A)

✅ Completed

  • Batch 1 complete: 5 agents audited (125 total skills)
  • Root skills classified: 123 → 70 active (Tier 0-3 taxonomy)
  • Conflict matrix created: 4 HIGH, 6 MEDIUM, 3 LOW severity conflicts identified
  • Consolidation strategy outlined (3-phase, 60-85 hours)

🟡 In Progress

  • Batch 2-3: 11 remaining agents (this week)
  • Complete conflict resolution matrix
  • Finalize root skills classification

Deliverables

  • ✅ PHASE-2B-SKILLS-AUDIT.md (root of repo)
  • ✅ Projects/active documentation with implementation timeline
  • 🟡 Complete agent audit (Batch 2-3)
  • ⏳ Consolidation roadmap (Phase B)
  • ⏳ Per-agent implementation tasks (Phase C)

Success Criteria

  • Complete audit of all 16 agents' skill directories
  • Clear ownership definition (shared vs. local vs. override)
  • Version conflict resolution documented
  • Scalable lookup system for developers
  • Governance rules established and CI/CD validated

Related

Next Steps

  1. Complete Batch 2-3 agent audit (this week)
  2. Create consolidation strategy document
  3. Design skill override system architecture
  4. Create per-agent consolidation child issues

Project Status: Phase A (Audit) — 50% complete
Timeline: 2-3 weeks for Phase A completion
Project Lead: @ashleyshaw

Definition of Ready (DoR)

  • Clear problem statement and expected outcome
  • Acceptance criteria defined
  • Related issues/dependencies identified
  • Required resources/approvals listed

Definition of Done (DoD)

  • All acceptance criteria met
  • Changes tested and validated
  • Documentation updated
  • Changes merged and deployed
  • Stakeholders notified

Activity

  1. ashleyshaw
    self-assigned this
    on Jul 24, 2026

  2. linear-code commented on Jul 24, 2026

    @linear-code
    linear-codeBot
    on Jul 24, 2026 – with Linear Code

    LS-1809

  3. github-actions commented on Jul 24, 2026

    @github-actions
    github-actionsBot
    on Jul 24, 2026 – with GitHub Actions
    Contributor

    ⚠️ This issue does not follow a required issue template.

    Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)

    The issue will remain open and flagged until the body is corrected.
    Please update the issue with one of the official templates:

    If this was opened by automation, update the automation to preserve the template sections before creating the issue.

  4. github-actions
    added
    migrate:status:needs-more-infoMissing details to proceed
    on Jul 24, 2026
  5. github-actions
    added this to the v1.0 milestone on Jul 24, 2026

  6. github-actions commented on Jul 24, 2026

    @github-actions
    github-actionsBot
    on Jul 24, 2026 – with GitHub Actions
    Contributor

    ⏱️ Aging and SLA annotation

    • Age: 12 day(s)
    • SLA state: SLA risk
    • Thresholds: warn at 7 days, breach at 14 days
    • Last updated: 2026-08-05T11:14:38.083Z

    Maintained by project-meta-sync workflow.

  7. ashleyshaw
    added the
    AI Ops
    issue type on Jul 26, 2026
  8. ashleyshaw
    added a parent issue on Jul 26, 2026
  9. ashleyshaw
    linked a pull request that will close this issuechore(changelog): recover missing 51 entries from June 23 - July 24 #1315on Jul 26, 2026
  10. ashleyshaw
    added
    migrate:type:auditAudit
    migrate:priority:normalDefault priority
    and removed
    migrate:status:needs-more-infoMissing details to proceed
    on Jul 29, 2026

  11. ashleyshaw commented on Aug 7, 2026

    @ashleyshaw
    ashleyshaw
    on Aug 7, 2026
    MemberAuthor

    📋 Project Planning Update — phase-2b-skills-audit

    This issue is related to the phase-2b-skills-audit active project.

    📁 Project Documentation

    ✅ Phase 1-3 Summary

    Comprehensive audits (Phase 1), planning standardization (Phase 2), and OpenSpec RFC generation (Phase 3) have been completed for this project. Full documentation available in the project directory.

    🎯 Recommended Actions

    1. Review Project Documentation for overview and timeline
    2. Consult OpenSpec RFC for implementation roadmap
    3. Check Related Issues for dependencies and prerequisites
    4. Reference Phase Documents for specific execution guidance

    🔗 Quick Links

    Co-Authored-By: Claude Haiku 4.5 noreply@anthropic.com

  12. ashleyshaw
    modified the milestones: v1.0, v1.1 on Aug 29, 2026
  13. lightspeed-project-automation
    changed the issue type from
    AI Ops
    to
    Task
    on Sep 7, 2026
  14. linear-code
    added
    priority:normal
    type:audit
    on Sep 8, 2026

  15. eleshar commented on Sep 23, 2026

    @eleshar
    eleshar
    on Sep 23, 2026
    Contributor

    Superseded by #3467, part of epic #3464 (agents and skills aligned with the official AGENTS.md, Agent Skills, GitHub Copilot and Claude Code standards). The plan this issue belonged to has been replaced there. Reopen if it covers something #3464 and its children do not.

  16. eleshar
    closed this as not plannedon Sep 23, 2026

  17. eleshar commented on Sep 23, 2026

    @eleshar
    eleshar
    on Sep 23, 2026
    Contributor

    Reopening: this has its own planned deliverables that #3464 and its child issues do not cover, so it is not superseded. It stays open as related work to #3464, and should follow the standards decided there (AGENTS.md, *.agent.md frontmatter, Agent Skills SKILL.md, plugin marketplace distribution).

  18. eleshar
    reopened this on Sep 23, 2026
  19. github-actions
    added
    status:needs-triage
    and removed
    migrate:priority:normalDefault priority
    migrate:type:auditAudit
    on Sep 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

priority:normalstatus:needs-triagetype:audit

Type

Task

Fields

Priority

None yet

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions