AI Prompts

Use these prompts with Claude, Cursor, ChatGPT, or any AI assistant to set up scribe compatibility automatically.

Hugo — full setup

I want to integrate my Hugo site with toa://scribe, a GitHub-native CMS editor.
Please make the following changes:

1. CREATE data/scribe.yaml:

framework: hugo
categories:
  - news
  - review
  - guide
authors:
  - [your-name]
edit_zones:
  - path: content/posts
    label: Blog posts
    type: markdown
  - path: data
    label: Data files
    type: data
shortcodes:
  - name: youtube
    label: YouTube Video
    icon: player-play
    fields:
      - { name: id, label: Video ID, type: string }

2. UPDATE single post template to display feature_image:
{{ with .Params.feature_image }}
  <img src="{{ . }}" alt="{{ $.Title }}" class="post-hero-image">
{{ end }}

3. UPDATE nav partial to render Site.Menus.main with children support.

4. UPDATE archetypes/default.md with: title, date, author, categories, tags, feature_image, draft.

5. CREATE static/images/posts/.gitkeep

After changes, commit everything to main.

Astro — full setup

I want to integrate my Astro site with toa://scribe, a GitHub-native CMS editor.
Please make the following changes:

1. CREATE src/data/scribe.yaml:

framework: astro
categories:
  - news
  - review
  - guide
authors:
  - [your-name]
edit_zones:
  - path: src/content/posts
    label: Blog posts
    type: markdown
  - path: src/data
    label: Data files
    type: data
shortcodes: []

2. UPDATE src/content.config.ts — add to posts schema:
feature_image: z.string().optional(),
draft: z.boolean().default(false),
categories: z.array(z.string()).default([]),
tags: z.array(z.string()).default([]),

Note: categories MUST be z.array(z.string()), not z.string().

3. UPDATE post hero component — add feature_image prop and use cover || feature_image.

4. UPDATE all post listing pages to filter: posts.filter(p => !p.data.draft)

5. CREATE public/images/posts/.gitkeep

After changes, commit everything to main.

New site from scratch

I'm creating a new [Hugo/Astro] static site that will be managed with toa://scribe.
Set up the project with full scribe compatibility from the start:

- Post front matter: title, date, author, categories (array), tags (array),
  feature_image (optional string), draft (boolean, default false)
- Hero component displays feature_image
- List pages filter draft posts
- Create scribe.yaml config file
- Create images folder: public/images/posts/ (Astro) or static/images/posts/ (Hugo)
- categories is always an array type — scribe writes categories as YAML array