hp-gen

Generates Astro pages, sections, and shared infrastructure from page-plan.json files.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill hp-gen-ohmyhotelco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hp-gen
Source: https://github.com/ohmyhotelco/hare-cc-plugins/tree/main/homepage-plugin/skills/hp-gen
Command: npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill hp-gen-ohmyhotelco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning homepage page plans into working Astro code requires manually scaffolding layouts, sections, SEO metadata, and i18n wiring for every page. This Skill automates that generation through a structured 3-phase pipeline with state tracking and resume support. ## Core Features & Use Cases - 3-Phase Generation Pipeline: Builds shared infrastructure (layout, header/footer, SEO utilities, i18n), then generates sections and assembles pages, then verifies with TypeScript, ESLint, and Astro build. - Resume & State Tracking: Records per-phase and per-page status in generation-state.json so interrupted runs can resume from the last incomplete phase instead of starting over. - Concurrency Safety: Uses a timestamped lock file with 30-minute stale-lock detection to prevent conflicting generation runs. - Use Case: After running hp-plan to define a marketing site's pages and sections, run this Skill to generate the full Astro project — MarketingLayout, React island components for interactive sections, JSON-LD structured data, and translation files — then verify everything compiles and builds. ## Quick Start Run /homepage-plugin:hp-gen to generate all planned pages, or pass a page name like /homepage-plugin:hp-gen home to generate a single page.

Frequently Asked Questions about hp-gen

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Astro pages from a page plan?▼

Run /homepage-plugin:hp-gen after creating page plans with hp-plan. It reads docs/pages/*/page-plan.json files, generates shared infrastructure first, then sections and pages, and finally verifies with TypeScript, ESLint, and astro build.

How do I generate only one page instead of all pages?▼

Pass the page name as an argument, for example /homepage-plugin:hp-gen home. The skill validates that docs/pages/home/page-plan.json exists and generates only that page, skipping the scan of other planned pages.

Can I resume a failed Astro page generation run?▼

Yes. The skill records per-phase and per-page status in generation-state.json. On rerun it detects completed phases and pages, then offers to resume from the first pending or failed item instead of restarting from scratch.

What happens if two generation processes run at the same time?▼

A lock file prevents concurrent runs. If a lock younger than 30 minutes exists, the skill exits with an in-progress message; locks older than 30 minutes are treated as stale, deleted, and replaced.

Why was ESLint skipped during the verification phase?▼

ESLint is skipped when no config exists and eslintTemplate is false, or when required dependencies like typescript-eslint or eslint-plugin-astro are missing. In the latter case the skill displays the pnpm install command to run.