Skip to content

Awesome GitHub Site - Add resource catalogue and category browsing #763

Description

@ashleyshaw

Summary

Build the complete resource catalogue structure with nine section pages, each presenting a distinct category of LightSpeed's AI operations assets. Each section should follow a consistent card-based pattern with filtering, sorting, and discovery support.

Section Pages Required

  1. /agents/ — AI agents (Claude, Copilot, etc.) with descriptions, capabilities, and config references
  2. /instructions/ — Role and behaviour instruction documents with metadata and use cases
  3. /skills/ — Reusable task automation skills with tags and capability indicators
  4. /hooks/ — Pre-commit and workflow guardrails with configuration examples
  5. /plugins/ — WordPress and development plugins with installation guides
  6. /workflows/ — Portable agentic workflows with dependency mapping
  7. /tools/ — Supporting utilities and CLI helpers with usage examples
  8. /learning-hub/ — Educational content, guides, and tutorials
  9. /getting-started/ — Team onboarding guide (how to use all sections)

Proposed Solution

  • Create consistent Astro layouts for hub pages (list views) and detail pages (full item view)
  • Implement Svelte components for filtering, sorting, and cards
  • Each section shares the same metadata structure (title, description, tags, links, category)
  • Navigation header updated with dropdown or expanded menu for all nine sections
  • Breadcrumb navigation on all detail pages

Acceptance Criteria

  • All nine section pages are created and deployed
  • Cards display consistently across all sections
  • Metadata structure is applied uniformly
  • Category and tag filtering works on list pages
  • Detail pages have consistent layout and navigation back to hub
  • Navigation menu reflects all nine sections
  • Mobile responsive layout verified
  • Documentation/changelog updated
  • Labels and issue types match repo standards

Designs / References

  • Awesome GitHub Copilot site reference structure (awesome-copilot.github.io)
  • Phase 2 planning docs

Dependencies

  • Phase 1 hosting and content shell must be stable ✓
  • Phase 2a homepage/navigation redesign should be complete before finalising this work

Testing Approach

  • Verify all nine sections render correctly and are accessible
  • Test category filtering and sorting on each hub page
  • Verify detail page navigation and breadcrumb links
  • Mobile responsiveness testing across all new pages
  • Accessibility testing (keyboard, screen reader, colour contrast)

Additional Context

This is the structural spine of the full site. The catalogue pattern should be reusable for future expansion without requiring layout changes."

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Priority

None yet

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions