🇺🇸English
Product Page Builder
Generate a complete content/products/{slug}/index.md for the 2389.ai Hugo site — frontmatter and body in one artifact.
This skill runs in a product repo but writes to the 2389.ai site repo.
Cross-Repo Setup
Before Phase 1, locate the 2389.ai site repo. Check in order:
~/Public/src/2389/2389.ai~/workspace/2389/2389.ai
If neither exists, ask the user for the path. Store it as SITE_REPO for the session.
Phase 1: Gather Context
Look for context in this order:
- README.md in the current directory
- CLAUDE.md in the current directory
- README.md or CLAUDE.md in the primary sub-directory
- docs/ folder
- If nothing found, ask the user to describe the product
If the repo contains multiple sub-projects, identify the primary deliverable. If unclear, ask the user which component the product page should focus on.
Pre-fill as much as possible from what you find. Confirm with the user — don't interrogate.
Required:
| Field | Notes |
|---|
| Product name | |
| What it does | 1-2 sentences |
| Who it's for | |
| Key features | 3-5 bullets |
| Install method | Command, brew, URL, etc. |
| Status | Skill, Tool, Platform, Alpha, Beta |
| GitHub repo URL | |
| Demo/docs URL | If exists |
| Tags | Lowercase |
Optional: Requirements/dependencies, architecture notes, known limitations.
Present the pre-filled fields as a table. Ask the user to confirm or correct before proceeding.
Phase 2: Generate
Produce the full index.md in one pass.
Frontmatter schema
title: "Product Name"
description: "One sentence. What it does and who it's for."
date: YYYY-MM-DD
status: "Skill|Tool|Platform|Alpha|Beta"
tags: ["relevant", "lowercase", "tags"]
github: "https://github.com/2389-research/repo"
demo: "https://url-if-exists"
weight: N
image_prompt: "..."
draft: true|false # Optional. Default: omit (page is published).
Image prompt rules
Every image_prompt follows this formula — only the subject metaphor changes:
- Subject: A metaphorical visual representing the product's function
- Medium: Heavy charcoal ink on warm cream paper
- Accent: Burnt orange ink highlights the key element
- Style: Flat perspective, no shadows, no depth, no photorealism, no gradients
- Texture: Risograph grain, high contrast ink work
- Composition: Brutalist editorial, inspired by vintage technical illustration (1960s industrial diagrams, tool catalogs, modular grids)
Example (for a parallel test runner):
A radial diagram of five identical circular vessels arranged in a pinwheel pattern, each containing a different abstract stage of the same process rendered as geometric patterns, drawn in heavy charcoal ink on warm cream paper. One vessel filled with burnt orange ink marks the winning variant. Bold ruled lines connect each vessel to a central decision node. Flat perspective, no depth, risograph grain texture, brutalist editorial composition inspired by 1960s industrial process diagrams. No photorealism, no gradients, high contrast ink work.
Body content structure
[Opening paragraph — what it is and why you'd care. 2-3 sentences. No throat-clearing.]
## Install
[Exact commands. No prose unless there are prerequisites.]
## What it does
[Core functionality. Explain like showing a colleague.
Specific features, not marketing bullets.
**Bold** for feature categories if there are several.]
## How it works
[Architecture or workflow. Skip for simple tools.]
## Requirements
[Dependencies, API keys, system requirements. Skip if none.]
Rules:
- Opening paragraph does the heavy lifting — no
## Overview header
## Install always present, always first after opener## What it does always present## How it works and ## Requirements only when they add value- No
## Conclusion — page ends when content ends
- 300-800 words total body content
- Tone: casual, technically credible, specific over abstract, contractions OK
Phase 3: De-AI Edit (HARD GATE)
Full sweep against known AI writing patterns. Fix every match before presenting.
| Pattern | Look for | Fix |
|---|
| Inflated significance | "revolutionary", "game-changing", "powerful" | State the fact plainly |
| Promotional language | "seamless", "robust", "elegant", "cutting-edge" | Cut or replace with specific detail |
| AI vocabulary | "delve", "leverage", "navigate", "foster", "landscape" | Use plain words |
| Copula avoidance | "serves as", "stands as", "boasts" | Just say "is" |
| Filler phrases | "In order to", "It's worth noting" | Delete |
| Excessive hedging | "could potentially", "might arguably" | Commit or cut |
| Throat-clearing | "In today's world of..." | Start with substance |
| Fake specificity | "a wide range of", "numerous" | Actual numbers or cut |
| Em dash overuse |
Product-page checks:
- Does the opening paragraph work without a heading above it?
- Could someone install this from the page alone?
- Is every feature described with enough specificity to be useful?
- Would this page make sense to someone who's never heard of the product?
- Does it end cleanly or trail off?
HARD GATE: Present the edited version with a summary of changes. Wait for user approval before Phase 4.
Phase 4: Output
Before saving, check if {SITE_REPO}/content/products/{slug}/index.md already exists. If it does, read the existing page. Preserve image_prompt, weight, and date from the existing page unless the user says otherwise. Note differences for the user.
- Save to
{SITE_REPO}/content/products/{slug}/index.md
- Run
hugo in the site repo to verify build. If the build fails, check for frontmatter YAML errors first.
- Present the file path and confirm success
What This Skill Does NOT Do
- No launch materials — that's
product-launcher:launch-materials
- No origin stories or motivation — humans add the soul
- No vibe discovery — visual language is established
- No landing page HTML — these are Hugo markdown pages
Weekly Installs
1
Repository
2389-research/c…-plugins
GitHub Stars
25
First Seen
1 day ago
Installed on
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
