For agents & contributors

Agent Skills

Each skill is a packaged workflow loaded when a task matches. They complement AGENTS.md with focused checklists for common repo tasks.

.agents/skills/<name>/SKILL.md

Add Collection

.agents/skills/add-collection/SKILL.md

Introduce a new Library collection ID with schema, i18n, Collection Explorer card, and docs catalog row. Use when adding industry verticals or curated resource groups like gym, clinic, restaurant.

collections schema i18n library docs

When to use

→ New industry vertical or themed bundle in the Library
→ Curated filter preset users browse as a first-class collection
→ ROADMAP phase delivering a vertical (Restaurant, Salon, Real Estate, …)

Content Authoring

.agents/skills/content-authoring/SKILL.md

Add or edit library resources in packages/content/resources with frontmatter, snippets, and MCP catalog regeneration. Use for any new resource type — components, patterns, prompts, animations, schemas, etc.

content mdx snippets schema mcp library

When to use

→ Any new Library resource (component, pattern, prompt, animation, schema, boilerplate, …)
→ Editing frontmatter, snippets, or README prose for an existing resource
→ After content changes that affect the MCP catalog

Create Site Pages (apps/www)

.agents/skills/create-site-pages/SKILL.md

Add new Astro pages to apps/www with i18n, SEO, sitemap, and optional nav links. Use when creating site routes like /changelog, /showcase, or any new top-level page on stealthis.dev.

astro www i18n routing pages seo

When to use

→ New top-level page on stealthis.dev (e.g. `/pricing`, `/about`, `/tools`)
→ New localized variant of an existing site page
→ Page needs nav entry, sitemap inclusion, or OG image

Page Resources (Library templates)

.agents/skills/page-resources/SKILL.md

Create full-page Library templates (category pages, type page) with HTML/CSS/JS snippets and Lab demos. Use when adding copy-paste page layouts like about-page, landing-page, or portfolio templates.

content pages lab html library templates

When to use

→ Landing pages, about pages, pricing pages, portfolios, dashboards
→ Full HTML page layouts developers can steal into their projects
→ Runnable Lab preview of the page design

How skills relate to other docs

AGENTS.md / CLAUDE.md Always-on project context and command reference
.agents/skills/*/SKILL.md Task-specific workflows loaded when relevant
CONTENT_AUTHORING.md Full reference for resource frontmatter and snippets
PHASE-WORKFLOW.md Multi-agent batch builds for ROADMAP phases (opt-in)

Anatomy of a skill

---
name: skill-id
description: When the agent should load this skill.
---

## When to use
## Workflow
## Checklist
## Related files

Optional subfolders (rules/, examples/) can hold deeper reference without bloating the entry point.