Skip to content

Help / 01

Working with AI agents

Every theme ships with instructions for AI coding agents, so Cursor, Claude Code, Codex, and Copilot follow the theme's conventions.

Browse the docs

BaseLayer themes are set up for AI coding agents. Each theme includes files that tell an agent where things live and which rules to follow, so its changes look like they belong.

What’s included

File What it does
AGENTS.md The project’s rules: where copy lives, how blocks work, what to run before finishing. Read by Cursor, Claude Code, Codex, Copilot, and most other agents
SKILLS.md Step-by-step recipes for common jobs: add a page, add a blog post, change the brand colors, swap the navbar
.cursor/rules/ Cursor rules that apply automatically, such as “colors come from tokens” and Astro gotchas

You don’t need to do anything to use them. Open the project in your editor and ask.

Prompts that work well

  • “Change the brand color to a deep green and update the hover and soft variants to match.”
  • “Add a services page with a hero, three service cards, and the CTA band. Put the copy in config.”
  • “Write a blog post about our spring launch using the sample post as a template.”
  • “Run the typecheck and build and fix anything that fails.”

Agents do best with one clear job at a time. Ask them to finish with npm run typecheck and npm run build; AGENTS.md already tells them to.

Keep the files current

If you change how your project works, for example by adding a CMS or a new collection, add a line to AGENTS.md. The agent only knows what the file tells it.