new-block

Generate YAML config, Zod schema, Astro component, and renderer integration for new page-section blocks.

Updated May 18, 2026
One-click install
npx skills add https://github.com/homeworkclubco/artlogicspecialist-v2 --skill new-block-homeworkclubco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-block
Source: https://github.com/homeworkclubco/artlogicspecialist-v2/tree/main/.claude/skills/new-block
Command: npx skills add https://github.com/homeworkclubco/artlogicspecialist-v2 --skill new-block-homeworkclubco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of new page-builder sections in the Artlogic Specialist website, ensuring consistency across the Pages CMS and Astro content collection schema.

Core Features & Use Cases

  • Schema Synchronization: Automatically maps new block requirements to .pages.yml and content.config.ts.
  • Component Scaffolding: Generates standardized Astro components using project-specific layout primitives.
  • Use Case: When a client requests a new "Testimonials Carousel" or "Stats Grid" section, this Skill ensures all four required files are created correctly to prevent runtime schema mismatches.

Quick Start

Ask the AI to add a new stats block with a heading and a list of items containing a value and a label.

Frequently Asked Questions about new-block

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

FAQPage Schema
How do I scaffold new page sections for Astro and a CMS?

Scaffolding new CMS-driven page sections for Astro requires generating the matching YAML configuration, Zod schemas, Astro components, and renderer integration simultaneously to prevent runtime schema mismatches.

Why do I get runtime schema mismatches when adding Astro content collections?

Runtime schema mismatches in Astro content collections occur when the CMS YAML configuration and the Zod schema in content.config.ts are not synchronized. You must update both files to reflect the new page block requirements.

Does scaffolding a new Astro block require updating multiple files?

Yes, adding a new Astro block requires a four-touchpoint architecture update. You must modify the .pages.yml file, content.config.ts Zod schema, the Astro component, and the renderer integration to maintain system consistency.

How do I generate a Zod schema for a new Astro page section?

To generate a Zod schema for a new Astro page section, you map the new block's content requirements directly to content.config.ts. This ensures the CMS input matches the validation rules enforced by the Astro content system.

What's the best way to standardize Astro components for a page builder?

The best way to standardize Astro components for a page builder is to generate them using project-specific layout primitives. This ensures that all newly scaffolded page sections adhere strictly to the existing design conventions.

Can I use this scaffolding approach for any Astro content system?

This scaffolding approach is designed specifically for the Pages CMS and Astro content system architecture. It requires strict adherence to a four-touchpoint file structure, making it highly specialized for this particular content-management workflow.