# New pSEO template

> Add a programmatic-SEO page template to a ZeroDirs directory site. Registers a pattern in src/features/paid/pseo/patterns.ts, adds its id to PSEO_TEMPLATE_ID…

You are reading one page of the ZeroDirs documentation. ZeroDirs is a paid Astro + Cloudflare Workers starter for directory sites: every page is rendered to static HTML at build time, the site ships no client JavaScript outside `/search/`, and one file — `site.config.ts` — carries roughly 80% of the customisation.

Two things to hold on to before you act on anything below:

- `site.config.ts` is validated by a zod schema with ten cross-field rules. After any edit to it, run `pnpm check:config`; every problem is reported as `site.config.ts › <path>: <message>` and the whole file is checked at once.
- The repository ships its own `AGENTS.md` with twenty hard rules, and a machine-checked test suite behind them. If you are working inside a ZeroDirs project, read that file first — it overrides anything general you infer from this page.

Source: https://zerodirs.com/docs/agents/recipes/new-pseo-template/

---

<!-- DO NOT EDIT — generated from zerodirs/zerodirs .agents/skills/ by .github/docs/generate.ts (docs-sync.yml). Edit the source, not this page. -->

`.agents/skills/new-pseo-template/SKILL.md` — 100 lines of instruction that ship inside the starter. This page is generated from it, so it says what the skill does without republishing it.

## When an agent picks this up

The skill description, verbatim — this is the text an agent matches your request against:

> Add a programmatic-SEO page template to a ZeroDirs directory site. Registers a pattern in src/features/paid/pseo/patterns.ts, adds its id to PSEO_TEMPLATE_IDS, writes the copy in site.config.ts, and adds a unit test. Use when asked for a new generated page type such as "X vs Y", "best X under $N", or "free X tools".

## What it walks through

1. Steps
   - Add the id
   - Write the pattern
   - Add the copy
   - Know what the generator will do to you
   - Add a case to `tests/unit/pseo.test.ts`
   - Optional per-page copy overrides
1. Verify

## Commands it runs

```sh
pnpm check
pnpm test
pnpm build
pnpm check:config
```

## Files it touches

`src/features/paid/pseo/patterns.ts` · `site.config.ts` · `src/config/schema.ts` · `src/config/types.ts` · `src/features/paid/pseo/generate.ts` · `tests/unit/pseo.test.ts` · `src/features/paid/pseo/copy.ts` · `integrations/budget.ts`

## Using it

Skills load themselves — you describe the outcome, not the skill. "Add a Compliance category with an icon and seed it" is enough for an agent that can see `.agents/skills/`; Claude Code reads `.claude/skills/`, which `pnpm skills:sync` mirrors from `.agents/` on every install. See [Working with an agent](https://zerodirs.com/docs/agents/overview/).