# Starlight Skills Installation

> Provides installation and basic setup instructions for starlight-skills. Use this when you need to add the plugin to a new Astro Starlight project or configure its initial setup. Do not use this if the plugin is already installed, or for frontmatter authoring rules.

- Skill: `mew-ton/starlight-skills-installation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mew-ton/starlight-skills-installation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mew-ton/starlight-skills-installation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: mew-ton (https://skillmd.com/u/mew-ton)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mew-ton/starlight-skills-installation

---


Adding `starlight-skills` to your Astro Starlight project is a simple two-step process.

## 1. Install the Package

Install the plugin using your preferred package manager:

```bash
# npm
npm install starlight-skills

# yarn
yarn add starlight-skills

# pnpm
pnpm add starlight-skills
```

## 2. Configure Astro

Add the plugin to your Starlight integration configuration inside `astro.config.ts` (or `astro.config.mjs`):

```ts
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
import starlightSkills from 'starlight-skills';

export default defineConfig({
	integrations: [
		starlight({
			title: 'My Docs',
			plugins: [
				// Add the starlight-skills plugin here!
				starlightSkills(),
			],
		}),
	],
});
```

Once added, any `.md` or `.mdx` file under `src/content/docs/` with `skill: true` in its frontmatter will be automatically processed. 

See the **Configuration** chapter to learn how to customize where your skills are output and how the site integration behaves.