Skip to content

GITHUB SKILLS MASTER ROADMAP

Jump to bottom
github-actions[bot] edited this page May 6, 2026 · 1 revision

GitHub Skills Spec Compliance: 6-Phase Master Roadmap

Project Goal: Achieve 100% GitHub Skills Specification compliance for all 25 accessibility agent skills
Current Status: Phases 1-2 Complete (4/6) ✓
Total Timeline: 6 weeks (April 10 - May 20, 2026)
Team Size: 3-5 core engineers + supporting roles

Phase Overview

Phase Name Duration Status Deliverables
1 Audit & Planning 2 days ✓ Complete Audit findings, compliance plan, priority matrix
2 Description Trimming 3 days ✓ Complete 23/25 skills trimmed to <200 chars
3 Validation Enhancement 5-7 days ⏳ Ready Enhanced validation script, link checking
4 Supply Chain Security 5-7 days 📋 Planned Code signing, SBOM, security policy
5 CLI Workflow 3-5 days 📋 Planned gh install integration, registry config
6 Testing & Release 7-10 days 📋 Planned Comprehensive testing, public release

Completed Work: Phases 1-2

Phase 1: Audit & Planning (✓ Complete)

Deliverables:

  • ✓ Created validation script enhancements (spec compliance checks)
  • ✓ Comprehensive audit of all 25 skills
  • ✓ Tiered remediation roadmap (Tier 1-4 prioritization)
  • ✓ Identified 23 skills exceeding <200 char threshold
  • ✓ Documentation: 3 planning documents

Validation Results: 0 errors, 0 warnings (structural)

Artifacts:

Phase 2: Description Trimming (✓ Complete)

Objective: Trim all skill descriptions to <200 characters per spec requirement

Results:

  • ✓ All 25 skills now compliant with <200 char limit
  • ✓ 23 skills trimmed (no changes needed: 2 already compliant)
  • ✓ Average reduction: 131 chars per skill (46% smaller)
  • ✓ Total characters freed: 3,291 chars

Tier-by-Tier Breakdown:

Tier Skills Char Range Avg Reduction Status
Tier 1 2 >400c → <200c -256c (64%) ✓
Tier 2 8 300-399c → <200c -220c (62%) ✓
Tier 3 8 250-299c → <200c -130c (49%) ✓
Tier 4 5 200-249c → <200c -97c (42%) ✓
Compliant 2 Already <200c 0c ✓

Validation Results: 0 errors, 0 warnings ✓

Process:

  • Batch updates using multi_replace_string_in_file (23 files in parallel)
  • Incremental validation after each tier
  • Fine-tuning on items just over threshold
  • Total effort: 3 hours

Artifacts:

Upcoming Work: Phases 3-6

Phase 3: Validation Enhancement (Ready to Start)

Target Dates: Apr 17-24, 2026
Status: 📋 Implementation Ready

Goals:

  • Enhance validation script with URL verification
  • Check WCAG criterion mappings
  • Verify documentation link integrity
  • Detect optional fields for future specification

Work Items (5 items, ~7 days total):

  1. URL verification module (2d)
  2. WCAG criterion validation (1.5d)
  3. Documentation link checking (1.5d)
  4. Optional fields detection (1d)
  5. Script integration & testing (1d)

Success Criteria:

  • ✓ All URLs verified (100% link health)
  • ✓ WCAG mappings validated (100% accurate)
  • ✓ Documentation completeness assessed
  • ✓ Validation script: 0 errors, 0 warnings
  • ✓ Performance: <5s for 25 skills

Owner: Script Lead (TBD)
Artifacts: PHASE-3-VALIDATION-ENHANCEMENT.md

Phase 4: Supply Chain Security (Planned)

Target Dates: Apr 25 - May 2, 2026
Status: 📋 Planning Phase

Goals:

  • Implement code signing for skill artifacts
  • Generate SBOM (Software Bill of Materials)
  • Create security policy documentation

Key Deliverables:

  • Code signing setup (ECDSA keys)
  • Signature verification in validation script
  • SBOM generation (CycloneDX format)
  • Security policy: SECURITY-SKILLS.md

Success Criteria:

  • ✓ 100% of skills signed
  • ✓ SBOM complete & published
  • ✓ Signature verification working
  • ✓ Security policy documented

Owner: Security Lead (TBD)
Artifacts: PHASES-4-5-6-ROADMAP.md

Phase 5: CLI Workflow & Publishing (Planned)

Target Dates: May 3-8, 2026
Status: 📋 Planning Phase

Goals:

  • Integrate with GitHub Skills CLI (gh cli v2.48+)
  • Configure registry for skill distribution
  • Prepare for GitHub Skills directory listing

Key Deliverables:

  • gh cli command integration
  • Skill registry configuration
  • Installation guides & documentation
  • GitHub Skills directory listing

Success Criteria:

  • ✓ gh skill install works
  • ✓ Skills resolve from registry
  • ✓ <30s installation time
  • ✓ Directory listing active

Owner: CLI Lead (TBD)
Artifacts: PHASES-4-5-6-ROADMAP.md

Phase 6: Testing & Public Release (Planned)

Target Dates: May 9-20, 2026
Status: 📋 Planning Phase

Goals:

  • Comprehensive testing across platforms
  • Beta testing with community
  • Final documentation review
  • Public release on GitHub Skills directory

Key Testing:

  • Unit tests (>95% coverage)
  • Integration tests (gh cli workflow)
  • Manual testing (macOS, Windows, Linux)
  • Beta testing with 10-20 testers

Release Deliverables:

  • Test results report
  • Beta feedback summary
  • Release notes & announcement
  • Community support channels

Success Criteria:

  • ✓ 100% test pass rate
  • ✓ >4.5/5 beta feedback score
  • ✓ >100 Day-1 installations
  • ✓ <24h support response time

Owner: Release Manager (TBD)
Artifacts: PHASES-4-5-6-ROADMAP.md

Project Timeline Visualization

WEEK 1  Apr 10-14  |========== PHASE 1: Audit ==========|
                   
WEEK 2  Apr 15-21  |=== PHASE 2 ==|========== PHASE 3: Validation ===========|
                   
WEEK 3  Apr 22-28  |====== PHASE 3 cont'd =====|===== PHASE 4: Security ====|
                   
WEEK 4  Apr 29-May 5|===== PHASE 4 cont'd =====|=== PHASE 5: CLI ==|
                   
WEEK 5  May 6-12   |=== PHASE 5 cont'd ===|========== PHASE 6: Testing ==========|
                   
WEEK 6  May 13-19  |========== PHASE 6: Testing & Release ==========|

May 20  ============ PUBLIC RELEASE ✓ ============

Milestone Tracking

Milestone Date Criteria Status
Phase 1 Complete Apr 14 Audit finished, plan approved ✓ Apr 14
Phase 2 Complete Apr 16 All skills <200 chars ✓ Apr 16
Validation Enhanced Apr 24 Script phase 3 ready ⏳ On track
Security Signed May 2 All artifacts signed ⏳ Scheduled
CLI Ready May 8 gh install working ⏳ Scheduled
Testing Complete May 18 All tests passing ⏳ Scheduled
Public Release May 20 Directory listing active ⏳ Scheduled

Key Metrics & KPIs

Current Status (End of Phase 2)

Metric Target Current Status
Structural Validation 0 errors 0 errors ✓ 100%
Spec Compliance 100% 100% (25/25) ✓ 100%
Description Length <200 chars 100% <200 ✓ 100%
Validation Warnings 0 0 ✓ 100%
Documentation Complete Complete ✓ 100%

Projected End-of-Project (May 20)

Metric Target Projected Status
Code Signing 100% 100% (25/25) ⏳ Scheduled
SBOM Coverage 100% 100% ⏳ Scheduled
Test Coverage >95% >95% ⏳ Scheduled
Community Beta Score >4.5/5 TBD ⏳ Scheduled
Day-1 Adoption >100 installs TBD ⏳ Scheduled

Resource Allocation

Phase Ownership

Phase Owner Size Status
1 Accessibility Lead + Script Lead 2 people ✓ Complete
2 Script Lead 1 person ✓ Complete
3 Script Lead 1 person ⏳ Assigned
4 Security Lead 1 person 📋 To assign
5 CLI Lead 1 person 📋 To assign
6 Release Manager 2-3 people 📋 To assign

Total Effort

  • Engineering: 25-30 person-days
  • Management: 5-10 person-days
  • QA/Testing: 7-10 person-days
  • Documentation: 5-7 person-days
  • Community/Support: 5 person-days
  • Total: ~57-72 person-days (8-10 weeks of person-effort)

Calendar Timeline

  • Start: April 10, 2026
  • Phase 1-2 Complete: April 16, 2026
  • Phase 3 Complete: April 24, 2026
  • Phase 4 Complete: May 2, 2026
  • Phase 5 Complete: May 8, 2026
  • Phase 6 Complete: May 20, 2026
  • Public Release: May 20, 2026

Dependencies & Critical Path

Critical Path (Must Complete In Order)

Phase 1 (Audit)
    ↓
Phase 2 (Description Trimming)
    ↓
Phase 3 (Validation Enhancement) ← Can start after Phase 2
    ↓
Phase 4 (Supply Chain Security) ← Blocker for Phase 5
    ↓
Phase 5 (CLI Workflow) ← Blocker for Phase 6
    ↓
Phase 6 (Testing & Release) ← Final phase

Parallel Opportunities

  • Phase 3 can partially overlap with end of Phase 2
  • Phase 4 & 5 can overlap by 2-3 days
  • Phase 6 testing can start before Phase 5 fully complete

External Dependencies

  • GitHub CLI v2.48+ availability
  • GitHub Skills directory API access
  • GitHub Actions infrastructure
  • Node.js build tools & ecosystem

Risk Management

High-Risk Items

Risk Probability Impact Mitigation
Low community adoption Medium High Strong marketing, clear docs
Security vulnerabilities Low Critical Security audit, pentesting
CLI integration delays Medium High Early testing with GitHub team
Performance issues Low Medium Continuous benchmarking

Risk Mitigation Strategies

  1. Early integration testing with GitHub CLI team
  2. Extensive compatibility matrix (macOS, Windows, Linux)
  3. Beta testing program to catch issues early
  4. Security audit & penetration testing before release
  5. Rollback plan for issues on public release day

Success Criteria: Project Complete

Technical Success

  • ✓ All 25 skills meet GitHub Skills specification
  • ✓ Code signing & SBOM implemented
  • ✓ CLI installation workflow functional
  • ✓ 100% of tests passing
  • ✓ <5% post-release defect rate

Quality Success

  • ✓ 0 critical security vulnerabilities
  • ✓ >95% test coverage
  • ✓ Zero high-severity defects
  • ✓ All documentation complete & accurate

Community Success

  • ✓ >100 Day-1 installations
  • ✓ >4.5/5 average rating
  • ✓ <24h support response time
  • ✓ Active community contributions & feedback

Business Success

  • ✓ GitHub Skills directory listing approved
  • ✓ Public release announcement published
  • ✓ Media coverage in accessibility community
  • ✓ Foundation for future skill expansion

Documentation Reference

Phase Summaries

Document Phase Details
SKILLS-COMPLIANCE-AUDIT.md 1 Audit methodology & findings
PHASE-2-COMPLETION-SUMMARY.md 2 Trimming results & process
PHASE-3-VALIDATION-ENHANCEMENT.md 3 Validation script enhancements
PHASES-4-5-6-ROADMAP.md 4-6 Supply chain, CLI, testing

Supporting Documentation

Document Purpose
GITHUB-SKILLS-SPEC-COMPLIANCE-PLAN.md Original 6-phase plan
GITHUB-SKILLS-SPEC-QUICK-REFERENCE.md Specification quick reference
README.md Project overview
.github/skills/*/SKILL.md Individual skill definitions

Next Steps

Immediate (Today)

  • Push Phase 2-6 documentation to feature branch
  • Review Phase 2 completion summary
  • Assign Phase 3 owner (Script Lead)

Short Term (This Week)

  • Begin Phase 3: Validation Enhancement
  • Set up URL verification module
  • Create test cases for validation

Medium Term (Next 2-4 weeks)

  • Complete Phase 3 by Apr 24
  • Begin Phase 4: Security signing
  • Complete Phase 4 by May 2
  • Begin Phase 5: CLI integration

Long Term (May)

  • Complete Phase 5 by May 8
  • Begin Phase 6: Comprehensive testing
  • Recruit beta testers
  • Execute public release May 20

Approval & Sign-Off

Project Sponsor: Accessibility Team Lead
Technical Lead: Script Lead
Quality Lead: QA/Testing Team
Release Authority: Release Manager

Role Name Approval Date
Sponsor (TBD) ⏳ Pending -
Tech Lead (TBD) ⏳ Pending -
QA Lead (TBD) ⏳ Pending -
Release (TBD) ⏳ Pending -

Contact & Support

For questions or issues related to this project:

Slack Channel: #github-skills-spec
Email: (TBD)
GitHub Discussions: Community-Access/accessibility-agents/discussions

Last Updated: April 16, 2026
Next Review: April 24, 2026 (End of Phase 3)
Document Version: 2.0

Getting Started

Agents

Orchestrators

  • Accessibility Lead
  • Web Accessibility Wizard
  • Document Accessibility Wizard

Web Specialists

  • Alt Text and Headings
  • ARIA Specialist
  • Contrast Master
  • Forms Specialist
  • Keyboard Navigator
  • Link Checker
  • Live Region Controller
  • Modal Specialist
  • Tables Data Specialist

Document Specialists

  • Word Accessibility
  • Excel Accessibility
  • PowerPoint Accessibility
  • PDF Accessibility
  • Office Scan Config
  • PDF Scan Config

Learning

  • Testing Coach
  • WCAG Guide

Scanning

Tools

Advanced

Clone this wiki locally