AI Skill

Give your AI assistant a 4567 skill file so it understands your site structure instantly.

Point any AI at your 4567 folder and it instantly knows how to work with it.

4567 is designed to be AI-native. The folder structure is dead simple, and the skill file below teaches any AI assistant (Claude, GPT, Cursor, Windsurf, etc.) how to navigate, read, and edit your site content without you explaining it twice.

How to use it

1. Download the skill file → 4567-skill.md
2. Copy it into your site folder → Drop it at the root, next to your main.md
3. Point your AI at the folder → The AI reads the skill file and understands everything

That's it. No setup. No configuration. Your AI now knows how 4567 works.

The Skill File

Below is the full content of the skill file. You can read it here or download it above.

4567-skill.md

# 4567 Skill File

You are working with a 4567 site. This file teaches you everything you need to know to navigate, read, and edit this site effectively.

## What is 4567?

4567 is a Go-based CLI tool that transforms any folder into a website. It runs locally at `localhost:4567` and exports static HTML. No servers, no databases, no build step.

## Folder Structure

site-root/
── main.md # Homepage content
├── about.md # About page
├── project-one/ # Each folder = one page
│ ├── project.md # Page metadata + content
│ ├── image1.jpg # Images auto-display
│ └── image2.jpg
└── category/ # Nested folders work too
└── sub-project/
└── project.md

### Hidden Folders (ignore these)
- `_drafts/`, `_archive/`, `_todo/` — underscore prefix = hidden
- `.4567/`, `.git/` — dot prefix = hidden
- These folders are NOT served or exported

## project.md Format

Every project folder has a `project.md` with YAML frontmatter:

```markdown
---
title: "Page Title"
description: "Brief SEO description"
keywords: ["tag1", "tag2"]
og_image: "hero-image.jpg"
featured: false
show_thumbnail: true
thumbnail_count: 1
year: "2024"
category: "design"
client: "Client Name"
tags: ["tag1", "tag2"]
color: "#1a1a2e, #ffffff"
published_at: "2024-01-15"
updated_at: "2024-03-20"
---

# Page content starts here

Markdown content...

Required Fields

• title — Page title
• description — Meta description

Optional Fields

• keywords — SEO keywords array
• og_image — Open Graph image (placed in project folder)
• featured — Show in featured section (default: false)
• show_thumbnail — Display thumbnail (default: true)
• thumbnail_count — Number of thumbnails (default: 1)
• year, category, client, tags — For filtering
• color — Custom gradient colors (background, text)
• published_at, updated_at — Publication dates
• external_link — Link to external URL

How to Help

Editing Content

1. Find the project.md in the relevant folder
2. Edit the frontmatter or body as needed
3. Save the file — changes appear instantly in the browser

Adding Images

• Place images directly in the project folder
• Use numbered names for order: 01-hero.jpg, 02-detail.jpg
• Images auto-display in a lightbox gallery

Creating New Pages

1. Create a new folder with a descriptive name
2. Add a project.md with frontmatter
3. The page appears automatically

Static Images in Markdown

Use absolute paths: <img src="/static/folder-name/image.png">

Key Rules

• Never edit files in _drafts/, _archive/, _todo/, or .* folders
• Always use title and description in frontmatter
• Use numbered folder prefixes for sorting (e.g., 01-features/)
• Test changes by opening localhost:4567 in a browser

Tone & Style

This site uses direct, personal language:

• Address the reader as "you"
• Use specific numbers and details
• Keep sentences short and punchy
• No corporate speak or jargon
• Raw, honest voice

If you need to export the site to static HTML, use: 4567 -path . -export

---

## What This Skill File Does

- **Teaches AI your structure** — The AI knows exactly where to find pages, images, and metadata
- **Prevents mistakes** — The AI won't edit hidden folders or break frontmatter
- **Saves time** — No need to explain 4567 to every new AI session
- **Works everywhere** — Claude, GPT, Cursor, Windsurf, any AI that reads markdown

## Why This Matters

Most AI assistants don't understand how your site is structured. They guess. They break things. They ask you the same questions every session.

This skill file fixes that. Drop it in your folder once, and every AI session starts with full context.

**Download:** [4567-skill.md](./4567-skill.md)