microhack-agentic-infraops

Category: Docs & Knowledge | Uploader: jonathan-vella | Downloads: 0 | Version: v1.0（Latest）

Guide changes to the Astro Starlight documentation site in `site/`.

Changelog: Source: GitHub https://github.com/jonathan-vella/microhack-agentic-infraops

Directory Structure

Current level: .github/skills/astro-starlight/

📄 SKILL.md 1.1 KB

SKILL.md

# Astro Starlight Skill

## Purpose

Guide changes to the Astro Starlight documentation site in `site/`.

## When to Use

- Adding or editing pages in `site/src/content/docs/`
- Modifying `site/astro.config.mjs` or Starlight configuration
- Creating or updating Astro components in `site/src/components/`
- Adjusting custom CSS in `site/src/styles/`

## Key References

- Use the **Astro Docs MCP server** (configured in `.vscode/mcp.json`) to verify current APIs
- Starlight sidebar uses `autogenerate` — page order is controlled via frontmatter `sidebar.order`
- Content lives in `site/src/content/docs/` as `.md` or `.mdx` files
- Files using Starlight components (`<Card>`, `<CardGrid>`, `<LinkCard>`) must have `.mdx` extension
- Mermaid support is provided by `rehype-mermaid-lite` + custom `Footer.astro` component

## Constraints

- Do not modify `site/src/content.config.ts` unless adding new collections
- Preserve Azure brand accent color (`#0078d4`) in theme customizations
- Keep `trailingSlash: "always"` in Astro config for URL consistency
- Admonitions use Starlight syntax: `:::note`, `:::tip`, `:::caution`, `:::danger`

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

microhack-agentic-infraops

Directory Structure

SKILL.md

Report

Notice