Skip to content

Commit 540feb9

Browse files
committed
fix(site): make home hero + feature cards clickable
Starlight's <Card> is display-only; <LinkCard> is the clickable variant, so all 4 home-page cards were dead. Switch to <LinkCard>. Also: hero frontmatter links and <LinkCard> href props don't run through Astro's base-path transformer, so on deployments with base='/skills-driven-development' they emitted bare '/why-skdd/' and 404'd against the domain root. Fix by hardcoding the base in the hero (YAML can't do expressions) and computing the base via import.meta.env.BASE_URL in an exported MDX constant for the cards. Expand from 4 to 6 cards to match the sidebar, and add a Quick start hero button pointing at /configuration/.
1 parent ec4d7f0 commit 540feb9

1 file changed

Lines changed: 40 additions & 13 deletions

File tree

site/src/content/docs/index.mdx

Lines changed: 40 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,21 @@ hero:
1111
link: /skills-driven-development/why-skdd/
1212
icon: right-arrow
1313
variant: primary
14+
- text: Quick start
15+
link: /skills-driven-development/configuration/
16+
icon: rocket
17+
variant: secondary
1418
- text: GitHub
1519
link: https://github.com/zakelfassi/skills-driven-development
1620
icon: external
21+
variant: minimal
1722
---
1823

19-
import { Card, CardGrid } from "@astrojs/starlight/components";
24+
import { Card, CardGrid, LinkCard } from "@astrojs/starlight/components";
25+
26+
export const base = import.meta.env.BASE_URL.endsWith("/")
27+
? import.meta.env.BASE_URL
28+
: `${import.meta.env.BASE_URL}/`;
2029

2130
## The one-minute pitch
2231

@@ -33,18 +42,36 @@ That one command scaffolds a canonical `skills/` directory, writes `.skills-regi
3342
## Explore
3443

3544
<CardGrid>
36-
<Card title="Why SkDD?" icon="star">
37-
The pitch, the lifecycle diagram, and who it's for. Start here if you want the narrative.
38-
</Card>
39-
<Card title="Configuration" icon="setting">
40-
Per-harness wiring: Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Goose, Amp.
41-
</Card>
42-
<Card title="Skill colony concept" icon="puzzle">
43-
What a colony is, how it differs from a static library, and the architecture diagram.
44-
</Card>
45-
<Card title="Forging skills" icon="seti:python">
46-
The `skillforge` meta-skill checklist and what the agent actually does when you say "forge this."
47-
</Card>
45+
<LinkCard
46+
title="Why SkDD?"
47+
href={`${base}why-skdd/`}
48+
description="The pitch, the lifecycle diagram, and who it's for. Start here if you want the narrative."
49+
/>
50+
<LinkCard
51+
title="Configuration"
52+
href={`${base}configuration/`}
53+
description="Per-harness wiring: Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Goose, Amp."
54+
/>
55+
<LinkCard
56+
title="Skill colony concept"
57+
href={`${base}skill-colony/`}
58+
description="What a colony is, how it differs from a static library, and the architecture diagram."
59+
/>
60+
<LinkCard
61+
title="Forging skills"
62+
href={`${base}forging-skills/`}
63+
description="The skillforge meta-skill checklist and what the agent actually does when you say 'forge this.'"
64+
/>
65+
<LinkCard
66+
title="Specification alignment"
67+
href={`${base}specification-alignment/`}
68+
description="How SkDD maps onto the agentskills.io v1 spec — what's spec-native vs SkDD-added."
69+
/>
70+
<LinkCard
71+
title="Harness integrations"
72+
href={`${base}integrations/claude-code/`}
73+
description="Dedicated guides for 11 harnesses: Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Goose, Amp, VS Code, Junie, Roo Code."
74+
/>
4875
</CardGrid>
4976

5077
## Principles

0 commit comments

Comments
 (0)