Skip to content

[Chore] Skills reference page on the landing site + changelog link #165

@atlas-apex

Description

@atlas-apex

Driver

The landing site site/index.html shows 4 representative flows in the multi-tab terminal but doesn't list the full skill surface anywhere. With 39 skills shipping in v1.2.0, an adopter who wants to know "what can /X do?" or "is there a skill for Y?" has to dig through .claude/skills/<name>/SKILL.md files in the repo. The CLAUDE.md "Available skills" table covers it but lives behind the GitHub UI, not on the public landing page.

The CHANGELOG also has no public link from the landing site. With v1.2.0 about to cut, having the link in place ahead of time means the release notes are one click away from the landing page on day 1.

Scope

Two small landing-site additions, one PR:

A. New site/skills.html reference page

  • Lists every skill in .claude/skills/<name>/SKILL.md (39 today)
  • Per-skill row: slash command (/setup), description (from frontmatter), argument format (from frontmatter argument-hint)
  • Loose categorisation (group similar skills) so the page scans quickly — Setup, Daily ops, Tickets, Specs, Review/merge, Audits, Lifecycle, Communications
  • Visual style matches site/index.html brutalist terminal aesthetic (mono font, paper colour, accent colour for active states, no decorative frames)
  • Single file, no JS dependencies, static only — same convention as the rest of the site
  • Link back to the homepage in the nav strip

B. Link the new page + CHANGELOG from the main site

  • Add skills nav link in the header titlebar (between existing nav items)
  • Add changelog nav link → https://github.com/me2resh/apexyard/releases (auto-updates with each tagged release; v1.2.0 lands and the link points there immediately)
  • Both linked targets open in the same tab (CHANGELOG releases page is on GitHub — target="_blank" for that one is fine)

Acceptance Criteria

  • site/skills.html exists, links from the main site nav
  • Every skill in .claude/skills/<name>/SKILL.md is represented (39 entries today)
  • Each entry shows: name, description, argument-hint (when present)
  • Skills are grouped into ~8 categories with section headers
  • Visual style matches the homepage (mono, paper, accent — no new design tokens)
  • No JS required for the skills page (static HTML + CSS)
  • Main site/index.html nav has skills link to the new page and changelog link to https://github.com/me2resh/apexyard/releases
  • markdownlint-cli2@0.13.0 clean on any docs touched (none expected — site changes only)
  • Mobile-responsive: tab strip on the homepage already wraps; the skills page should also read OK on a phone

Risks / Dependencies

  • No mechanism change. Pure marketing-site addition.
  • Skill drift — when new skills are added or skill descriptions change, this page goes stale. Mitigation: the page is generated from the same SKILL.md frontmatter that drives the runtime, so a follow-up ticket could automate the build (small Bash / Node script that walks .claude/skills/*/SKILL.md, parses YAML frontmatter, emits the rendered HTML). Out of scope for v1.2.0 — first version is hand-written and will need maintenance until the generator lands.
  • Refs me2resh/apexyard#160 (release v1.2.0 + site refresh). Counts as the second site-side deliverable for that ticket.

Refs: continued from PR #162 multi-tab terminal.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium — plan-worthy, not urgent

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions