authoring

Generate an AEM Edge Delivery Services authoring guide from repository and Config Service data.

1|6|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/aemsites/summit-portal --skill authoring-aemsites
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring
Source: https://github.com/aemsites/summit-portal/tree/main/skills/aem/edge-delivery-services/authoring
Command: npx skills add https://github.com/aemsites/summit-portal --skill authoring-aemsites

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Projects often lack clear, actionable documentation for content authors taking over an AEM Edge Delivery Services codebase, leaving teams unsure how to use blocks, templates, configuration sheets, and publishing workflows. This skill analyzes the repository and project configuration, consolidates author-facing instructions, and produces a professional PDF handover for authors and content managers.

Core Features & Use Cases

  • Project validation: Verifies repository is an Edge Delivery Services project and enforces required checks before proceeding.
  • Config-driven site discovery: Calls the Config Service to enumerate sites and derive DA and preview/live URLs rather than relying on local files.
  • Authoring documentation: Generates a structured AUTHOR-GUIDE.md containing blocks, templates, configuration sheets, workflows, and quick tasks, then converts it to a professional PDF for distribution.
  • Use cases: Onboarding new content authors, handing over a project to a client team, and creating repeatable authoring guides across multi-site or repoless setups.

Quick Start

Generate an authoring guide for the current project and save the final PDF to project-guides/AUTHOR-GUIDE.pdf.

Frequently Asked Questions about authoring

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

FAQPage Schema
How do I generate an authoring guide for an AEM Edge Delivery Services project?

To generate an authoring guide for an AEM Edge Delivery Services project, use this skill to analyze your repository structure and Config Service site data. It produces a structured markdown guide covering blocks, templates, and workflows, then converts it to a professional PDF for distribution.

What is the best way to onboard content authors to an Edge Delivery Services codebase?

The best way to onboard content authors to an Edge Delivery Services codebase is to provide a comprehensive authoring guide. This skill consolidates author-facing instructions for blocks, configuration sheets, and publishing workflows into a consolidated PDF handover document.

How does the Config Service API support AEM content authoring documentation?

The Config Service API at admin.hlx.page supports content authoring documentation by enabling site discovery. This skill calls the Config Service to enumerate sites and derive preview, live, and DA URLs rather than relying on local files.

Do I need a specific setup to create a PDF authoring guide for a repoless AEM project?

Yes, to create a PDF authoring guide for a repoless AEM project, you need your organization and authToken stored in .claude-plugin/project-config.json. You also need permission to create the project-guides/AUTHOR-GUIDE.md file and convert it to PDF.

Can I document blocks and configuration sheets across multiple AEM sites?

Yes, you can document blocks and configuration sheets across multiple AEM sites. This skill supports multi-site and repoless setups by validating the repository and using Config Service data to generate repeatable authoring guides for your projects.

Why does my AEM authoring guide generation fail before creating the PDF?

Authoring guide generation fails if the repository is not validated as an Edge Delivery Services project or if required checks are not met. Ensure your Config Service API access and authentication details in .claude-plugin/project-config.json are correctly configured.