Prompt Library

Read AGENTS.md and SKILLS.md, then look at src/config/config.toml,
src/pages/[...lang]/index.astro, src/content/homepage/english/-index.md, and
src/content/sections/english/hero-section.md. Summarize in 10 bullet points how this Astro theme
is organized: where text lives, how a page picks its sections, how a named block in a page's
frontmatter overrides a section, where the block names come from, how a page picks its header and
footer layout, and which collections npm run astro-check actually validates. Don't change any
files yet.

Here is my practice. Use it for every copywriting request in this conversation:
- Name: [FIRM NAME]
- What we do: [ONE SENTENCE]
- Clients: [WHO THEY ARE]
- Services: [3 TO 6 SERVICES]
- Country and regulator: [WHERE WE PRACTISE]
- Tone: precise, plain, reassuring. No hype.
Never invent client names, testimonials, savings figures, qualifications, licence numbers,
memberships, or fees. If you need one, leave the sample value and list it for me.
Confirm with one line, and don't change any files yet.

Change the brand from "Taxo" to "[NAME]". In src/config/config.toml update [site] title and
logoText, and [seo] author. Then set common.siteDescription and common.tagline in every
src/i18n/<language>.json, and search src/content and src/config for any remaining "Taxo" in
visible text and replace it. Don't rename files or code identifiers.

My brand color is [HEX] and my accent color is [HEX]. In src/styles/theme.css update
--color-primary and --color-accent, and adjust --color-secondary, --color-body,
--color-body-dark, and --color-accent-dark to match. Keep at least 4.5:1 contrast for text on
--color-body and on --color-body-dark. Don't add arbitrary color values anywhere else, and don't
touch the typography tokens. List the values you chose.

Replace Jost with [GOOGLE FONT] for --font-primary and Syne with [GOOGLE FONT] for
--font-secondary in src/config/fonts.json. Keep the cssVariable names, the weights, the
fallbacks, and the IBM Plex Sans Arabic entry (it is loaded only on Arabic pages). Don't edit any
CSS file. Remind me to restart npm run dev.

I added my logo at src/assets/images/[FILE].png and a light version at
src/assets/images/[FILE]-light.svg. In src/config/config.toml set [site] logo and logoAlternate
to those paths, adjust logoWidth and logoHeight to keep their proportions, and set logoText to
[NAME OR ""]. Also set image under [site.favicon] to the main file, and tell me to run
npm run generate-favicons.

I want the second homepage as my main homepage. Replace the sections of
src/pages/[...lang]/index.astro with the ones in src/pages/[...lang]/home-two.astro, and copy any
named blocks from its content file into src/content/homepage/english/-index.md (same for french
and arabic). Keep the headerLayout and footerLayout props that home-two uses. Then delete the
other homepage route and its content file, and remove it from the Home menu in every
src/config/menu.<language>.json. Run npm run astro-check.

Rewrite the English homepage text for my practice. The homepage is
src/pages/[...lang]/index.astro. Edit the named blocks in
src/content/homepage/english/-index.md and the section files it uses in
src/content/sections/english/. Keep every key, option, icon name, image path, and the number of
items in each list. Only change text values. Then write the french and arabic versions, with
identical keys.

On the homepage (src/pages/[...lang]/index.astro), move [SECTION] above [SECTION] and remove
[SECTION]. Only edit the route file: don't delete any content files, and remove imports that are
no longer used. Then run npm run astro-check.

On [PAGE, for example /about/], change [WHAT] for that page only. Add or edit the matching named
block in that page's frontmatter in src/content/[about-us | pricing | faq | contact]/english/
-index.md, using a block name that exists in src/sections.schema.ts. Leave the file in
src/content/sections/english/ alone so other pages keep the current text. Do the same for french
and arabic.

On [PAGE ROUTE in src/pages/[...lang]/], use headerLayout "[header-1 | header-2]" and
footerLayout "[footer-1 | footer-2]". Set those props on Base in that route file only. Don't
change Base.astro, whose defaults are header-2 and footer-1.

Change the blog section on [PAGE] to the "[VALUE]" layout. Set options.layout in
src/content/sections/english/blog-section.md (or blog-section-two.md), using one of the values
from the comment next to it. Make the same change in the french and arabic copies, then run
npm run astro-check.

In every src/config/menu.<language>.json: keep only links to the pages I use ([LIST]), and set
"enable": false on the rest in headerPrimary, footerPrimary, and footerSecondary. Keep the JSON
shape, the weight values, and the same items in every language. Then check the header on desktop,
with the keyboard, and in the mobile menu.

Turn the "[MENU NAME]" item in headerPrimary into a mega menu in every
src/config/menu.<language>.json. Use hasMegaMenu: true with menus as groups of
{ enable, name, description, icon, url, weight }, following the shape documented in AGENTS.md
under "Menus and Mega Menu". Add the cta card with [DETAILS] and the bottom bar with
[TEXT, LABEL, URL].

Create a page at /[slug]/ with these sections: [AboutSection, FeaturesGrid, TestimonialSection,
CtaSection]. Follow the "Add a new page" skill in SKILLS.md: copy src/pages/[...lang]/about.astro,
keep its getStaticPaths, and compose it from the section components. Put the page's own copy in
named blocks in a new content file, using block names from src/sections.schema.ts. Add "[slug]" to
headerPrimary in every src/config/menu.<language>.json, then run npm run astro-check.

I don't need these pages: [LIST, for example /case-studies/, /faq/, /team/]. For each one, delete
its route file or folder in src/pages/[...lang]/ and its content folder in src/content/, remove it
from src/lib/utils/aiContent.ts if it is listed there, then remove every link to it from each
src/config/menu.<language>.json and from content files (search for the URL). Run
npm run astro-check and npm run build, and fix anything they report.

I only need English. Set enable = false under [settings.multilingual] in src/config/config.toml.
Don't delete any files yet. Then tell me exactly what npm run toml:watch and
npm run remove-multilingual would do, and which lines I should remove from netlify.toml.

Add [LANGUAGE] (code "[xx]", folder "[name]", locale "[xx-XX]", social locale "[xx_XX]") and keep
the other languages. Follow the "Add or remove a language" skill in SKILLS.md: run
npm run generate-multilingual-content with those values, add a /[xx]/* block to netlify.toml, and
add a font entry to src/config/fonts.json if the script needs its own font. Then translate the
copied content folders, src/config/menu.[xx].json, and src/i18n/[xx].json, keeping every key,
icon name, URL, and number. Any Markdown link written inside a frontmatter string needs the
/[xx]/ prefix in that folder.

Search src/content/*/french/ and src/content/*/arabic/ (every collection) for Markdown links inside
frontmatter strings, such as [text](/about/), and add the language prefix: /fr/about/ and
/ar/about/. Don't touch button or menu url fields, which the code localizes, and don't change the
English folder.

The [Arabic | French] content is machine translated. Review src/content/[FOLDER]/
[arabic | french] and src/i18n/[ar | fr].json and rewrite the text so it reads naturally for a
professional-services audience. Keep every key, number, URL, and icon name exactly as it is, and
don't change the English files. For Arabic, keep numbers, emails, and URLs left to right.

Connect the contact form to [Formspree with form ID xxxx | formsubmit.co with [EMAIL] | Netlify
Forms]. Update contactFormAction and contactFormProvider in src/config/config.toml, following the
comments next to them. Don't change the form fields.

The contact form should ask for: [LIST OF FIELDS]. Edit the form.inputs list in
src/content/sections/english/contact-section.md and contact-section-two.md, and make the same
change in the french and arabic copies. Don't edit widgets/ContactForm.astro. Keep the existing
field shape and the required flags. Don't add a field that would collect tax identifiers or other
sensitive data by email.

For each page's -index.md in src/content/*/english/ and each file in src/content/pages/english/,
write a metaDescription of 140-160 characters based on that page's real content. Only add or
change metaDescription. Then do the french and arabic versions.

Review this site before launch and list what is still demo content. Check: baseUrl in [site] in
src/config/config.toml (it ships as https://example.com), contactFormAction, formAction under
[settings.subscription], [settings.contactInfo], the contact details in
src/content/sections/*/contact-section.md and contact-section-two.md, social links in
src/config/social.json, every fee in src/content/sections/*/pricing-section.md, the placeholder
bodies in src/content/services/, the sample outcomes in src/content/case-studies/, the sample team
in src/content/team/, the sample quotes in src/content/testimonial/, the legal pages in
src/content/pages/, any qualification or membership claim in the content, any "#" or example.com
links in the menus and content, and any remaining "Taxo" in visible text. Don't change files:
list the file and the line for each item.

npm run [dev | build | astro-check] fails with this error:
[PASTE THE FULL ERROR]
Explain the cause in one sentence, then fix it with the smallest change. Don't change unrelated
files.

I changed [WHAT] in [FILE] but the page [URL] still shows the old version. Find where that page
gets this text: check the named block in the page's frontmatter, whether that block name is a key
of sectionsSchema in src/sections.schema.ts, and the section file in
src/content/sections/english/. Tell me which one wins and why. Don't change anything yet.

On [PAGE] at /ar/, [WHAT LOOKS WRONG]. Follow the RTL Rules in AGENTS.md: replace physical
classes with logical ones, add rtl: handling for translate-x, transform origins, and gradients,
and add any direction-bearing icon to the rtlFlipIcons list in
src/layouts/helpers/Icons.astro rather than at the call site. Then tell me what to check at /ar/.