astro-starlight

Name: astro-starlight
Author: fusengine

21stars3forks

How to install astro-starlight?

fusengine/agents/astro-starlight

$npx -y skills add fusengine/agents --skill astro-starlight

Installs into the current project.

Summary

Astro Starlight documentation theme — setup, sidebar config, Pagefind search, dark/light mode, plugins (DocSearch, blog, openapi, typedoc, versions), multi-language, Content Layer API, llms.txt, customization. Use for building documentation sites.

Files · 1

View on GitHub

SKILL.md

1	# Astro Starlight
2
3	Production-ready documentation theme for Astro with built-in search, dark mode, i18n, and rich plugin ecosystem.
4
5	## Agent Workflow (MANDATORY)
6
7	Before ANY implementation, use `TeamCreate` to spawn 3 agents:
8
9	1. fuse-ai-pilot:explore-codebase - Analyze existing Starlight config, sidebar, and content structure
10	2. fuse-ai-pilot:research-expert - Verify Starlight plugin APIs via Context7/Exa
11	3. mcp__context7__query-docs - Check Starlight docs for Content Layer and i18n patterns
12
13	After implementation, run fuse-ai-pilot:sniper for validation.
14
15	---
16
17	## Overview
18
19	### When to Use
20
21	- Building technical documentation sites
22	- Creating API reference docs (with starlight-openapi)
23	- Generating docs from TypeScript types (with starlight-typedoc)
24	- Adding a blog to a documentation site (with starlight-blog)
25	- Setting up versioned documentation (with starlight-versions)
26	- Multi-language documentation with hreflang support
27
28	### Why Starlight
29
30	\| Feature \| Benefit \|
31	\|---------\|---------\|
32	\| Pagefind built-in \| Full-text search, zero config \|
33	\| Dark/light mode \| Automatic, CSS custom properties \|
34	\| Sidebar config \| Filesystem-based or manual groups \|
35	\| Plugin ecosystem \| DocSearch, blog, openapi, typedoc \|
36	\| Content Layer API \| Astro 7 content collections integration \|
37	\| llms.txt support \| `starlight-llms-txt` for AI discoverability \|
38
39	---
40
41	## Reference Guide
42
43	### Concepts
44
45	\| Topic \| Reference \| When to Consult \|
46	\|-------\|-----------\|-----------------\|
47	\| Setup \| [setup.md](references/setup.md) \| Installation, project structure \|
48	\| Sidebar \| [sidebar-config.md](references/sidebar-config.md) \| Navigation, groups, auto-gen \|
49	\| Search \| [search.md](references/search.md) \| Pagefind, DocSearch, exclude pages \|
50	\| Plugins \| [plugins.md](references/plugins.md) \| Blog, openapi, typedoc, versions \|
51	\| i18n \| [i18n-multilang.md](references/i18n-multilang.md) \| Locales, translations, hreflang \|
52	\| Content Layer \| [content-layer.md](references/content-layer.md) \| docsLoader, schema, collections \|
53	\| Customization \| [customization.md](references/customization.md) \| CSS variables, components override \|
54
55	### Templates
56
57	\| Template \| When to Use \|
58	\|----------\|-------------\|
59	\| [starlight-config.md](references/templates/starlight-config.md) \| Full astro.config.mjs with Starlight \|
60	\| [sidebar-example.md](references/templates/sidebar-example.md) \| Complex sidebar with groups and badges \|
61
62	---
63
64	## Best Practices
65
66	1. Start with filesystem sidebar - Add manual config only when needed
67	2. Keep Pagefind for small sites - DocSearch for high-traffic or large docs
68	3. Use `starlight-llms-txt` - AI crawlers increasingly important for docs
69	4. Content Layer schema - Type-safe frontmatter prevents runtime errors
70	5. CSS custom properties - Override theme without component slots

People who liked this also viewed

6 picks

Type

astro-starlight

21stars3forks

View on GitHub

How to install astro-starlight?

fusengine/agents/astro-starlight

$npx -y skills add fusengine/agents --skill astro-starlight

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Astro Starlight
2
3	Production-ready documentation theme for Astro with built-in search, dark mode, i18n, and rich plugin ecosystem.
4
5	## Agent Workflow (MANDATORY)
6
7	Before ANY implementation, use `TeamCreate` to spawn 3 agents:
8
9	1. fuse-ai-pilot:explore-codebase - Analyze existing Starlight config, sidebar, and content structure
10	2. fuse-ai-pilot:research-expert - Verify Starlight plugin APIs via Context7/Exa
11	3. mcp__context7__query-docs - Check Starlight docs for Content Layer and i18n patterns
12
13	After implementation, run fuse-ai-pilot:sniper for validation.
14
15	---
16
17	## Overview
18
19	### When to Use
20
21	- Building technical documentation sites
22	- Creating API reference docs (with starlight-openapi)
23	- Generating docs from TypeScript types (with starlight-typedoc)
24	- Adding a blog to a documentation site (with starlight-blog)
25	- Setting up versioned documentation (with starlight-versions)
26	- Multi-language documentation with hreflang support
27
28	### Why Starlight
29
30	\| Feature \| Benefit \|
31	\|---------\|---------\|
32	\| Pagefind built-in \| Full-text search, zero config \|
33	\| Dark/light mode \| Automatic, CSS custom properties \|
34	\| Sidebar config \| Filesystem-based or manual groups \|
35	\| Plugin ecosystem \| DocSearch, blog, openapi, typedoc \|
36	\| Content Layer API \| Astro 7 content collections integration \|
37	\| llms.txt support \| `starlight-llms-txt` for AI discoverability \|
38
39	---
40
41	## Reference Guide
42
43	### Concepts
44
45	\| Topic \| Reference \| When to Consult \|
46	\|-------\|-----------\|-----------------\|
47	\| Setup \| [setup.md](references/setup.md) \| Installation, project structure \|
48	\| Sidebar \| [sidebar-config.md](references/sidebar-config.md) \| Navigation, groups, auto-gen \|
49	\| Search \| [search.md](references/search.md) \| Pagefind, DocSearch, exclude pages \|
50	\| Plugins \| [plugins.md](references/plugins.md) \| Blog, openapi, typedoc, versions \|
51	\| i18n \| [i18n-multilang.md](references/i18n-multilang.md) \| Locales, translations, hreflang \|
52	\| Content Layer \| [content-layer.md](references/content-layer.md) \| docsLoader, schema, collections \|
53	\| Customization \| [customization.md](references/customization.md) \| CSS variables, components override \|
54
55	### Templates
56
57	\| Template \| When to Use \|
58	\|----------\|-------------\|
59	\| [starlight-config.md](references/templates/starlight-config.md) \| Full astro.config.mjs with Starlight \|
60	\| [sidebar-example.md](references/templates/sidebar-example.md) \| Complex sidebar with groups and badges \|
61
62	---
63
64	## Best Practices
65
66	1. Start with filesystem sidebar - Add manual config only when needed
67	2. Keep Pagefind for small sites - DocSearch for high-traffic or large docs
68	3. Use `starlight-llms-txt` - AI crawlers increasingly important for docs
69	4. Content Layer schema - Type-safe frontmatter prevents runtime errors
70	5. CSS custom properties - Override theme without component slots

People who liked this also viewed

6 picks

Type