astro-template-guidance

---
name: astro-template-guidance
description: Use this skill whenever you need to understand how the template works, including adding new pages, managing content, configuring pages, using components, understanding project architecture, using scripts, or styling and theming. Use it for ANY question related to the structure, usage, and customization of the project template.
---

# Template Guidance

This skill acts as the unified handbook for the template. It uses the progressive disclosure pattern to keep context lean. 

Depending on the user's specific request, **you MUST use the `view_file` tool to read the appropriate reference document** from the `references/` directory before proceeding.

## Routing Guide

Read the specific file in `references/` based on the user's request:

- **Adding a new page, route, or section:** 
  Read: `references/adding-new-pages.md`

- **Using, modifying, or understanding UI components (e.g. BlogCard, SeoMeta):** 
  Read: `references/component-usage.md`

- **Adding, editing, or updating markdown/MDX content (blog posts, etc.):** 
  Read: `references/content-management.md`

- **Configuring site settings, navigation, social links, or SEO (config.json, menu.json):** 
  Read: `references/page-configuration.md`

- **Understanding the high-level codebase structure or data flow:** 
  Read: `references/project-architecture.md`

- **Running custom pnpm scripts (dev, build, generators):** 
  Read: `references/script-usage.md`

- **Customizing styles, Tailwind CSS v4, dark mode, or the theme engine:** 
  Read: `references/styling-and-theming.md`

## Instructions

1. Identify the domain of the user's request.
2. View the corresponding reference markdown file in `references/` relative to this skill.
3. Follow the instructions within that reference file.

More agent context in zeon-studio/astroplate

3 other files this repository gives its agents.