Skip to content

docs(homepage): Redesign to lead with skills#238

Merged
dcramer merged 2 commits intomainfrom
docs/homepage-redesign-skills
Mar 5, 2026
Merged

docs(homepage): Redesign to lead with skills#238
dcramer merged 2 commits intomainfrom
docs/homepage-redesign-skills

Conversation

@dcramer
Copy link
Member

@dcramer dcramer commented Mar 5, 2026

Redesign the homepage to lead with Warden's core value prop: skills are Markdown files that compose into review agents. The previous homepage showed only a React example (vercel-react-best-practices), biasing visitors into thinking Warden is a React linter.

The new structure:

  • Hero with updated subtitle emphasizing skills and composition
  • Value prop strip (skills are Markdown, composable, run anywhere)
  • "What's a Skill?" centerpiece showing a real SKILL.md with syntax highlighting
  • Quick start with language-agnostic examples (security + API design skills)
  • PR mock showing SQL injection finding with parameterized query fix
  • Expanded Next Steps (Write a Skill, Configure Triggers, CLI Reference)

Also adds pnpm docs convenience script for running the docs dev server.

Fixes GH-236

Replace the React-biased homepage with a skills-first design that
communicates Warden's core value prop: defining and composing custom
review skills in Markdown.

- Update hero subtitle to emphasize skills and composition
- Add value prop strip (three-column: Markdown, composable, run anywhere)
- Add "What's a Skill?" centerpiece with syntax-highlighted SKILL.md
- Replace React example with language-agnostic security/API findings
- Show two skill boxes in terminal output to demonstrate composition
- Update PR mock with SQL injection finding and parameterized query fix
- Expand Next Steps from 2 to 3 cards (Write a Skill, Triggers, CLI)
- Add `pnpm docs` script for running the docs dev server
- Link to skills.sh for community skill discovery

Refs GH-236
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dcramer dcramer marked this pull request as ready for review March 5, 2026 18:21
@dcramer dcramer enabled auto-merge (squash) March 5, 2026 18:25
@dcramer dcramer disabled auto-merge March 5, 2026 18:25
@dcramer dcramer enabled auto-merge (squash) March 5, 2026 18:26
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dcramer dcramer merged commit 8d418aa into main Mar 5, 2026
11 checks passed
@dcramer dcramer deleted the docs/homepage-redesign-skills branch March 5, 2026 18:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: lead with skill-insertion as the core value prop

1 participant