handover-admin

Generate admin handover documentation for AEM Edge Delivery Services projects via the Config Service API.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aemgdc/aemdev --skill handover-admin-aemgdc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handover-admin
Source: https://github.com/aemgdc/aemdev/tree/main/.agents/skills/handover-admin
Command: npx skills add https://github.com/aemgdc/aemdev --skill handover-admin-aemgdc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Handing over administration of an AEM Edge Delivery Services project requires accurate, project-specific documentation of URLs, permissions, and Admin API operations, which is tedious and error-prone to write manually. ## Core Features & Use Cases - Config Service Discovery: Authenticates and fetches organization, site, code repository, and content source details directly from the Config Service API rather than guessing from fstab.yaml or git remotes. - Complete Admin Guide Generation: Produces a structured ADMIN-GUIDE covering login/logout, user and role management, preview/publish/unpublish operations, cache purging, code sync, common tasks, and troubleshooting. - Multi-Site Support: Detects repoless multi-site setups and documents each site with its preview URL, live URL, and content source. - PDF Output: Converts the finished guide into a professional PDF at project-guides/ADMIN-GUIDE.pdf via the whitepaper skill. - Use Case: When onboarding a new site administrator, run this Skill to produce a ready-to-share admin handbook with all endpoints pre-filled for the actual organization and sites. ## Quick Start Ask the assistant to generate an admin handover guide for this AEM Edge Delivery Services project and provide your Config Service organization name when prompted.

Frequently Asked Questions about handover-admin

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

FAQPage Schema
How do I create an admin guide for an AEM Edge Delivery Services project?▼

Run this Skill from the project root and provide your Config Service organization name when prompted. It authenticates, fetches site configuration from the Config Service API, and generates a complete admin guide as a PDF at project-guides/ADMIN-GUIDE.pdf.

What information does the generated admin documentation include?▼

The guide covers login and logout procedures, user and role management, preview, publish, unpublish, and cache purge endpoints, code sync operations, common admin tasks, and troubleshooting for HTTP errors like 401, 403, and 429.

Does the admin guide support multi-site or repoless setups?▼

Yes. The Skill fetches all sites under the organization from the Config Service API and detects repoless setups when multiple sites exist. It then documents each site with its preview URL, live URL, and content source.

Why does the Skill use the Config Service API instead of fstab.yaml?▼

The Config Service API is the only reliable source for site information in Edge Delivery Services projects. fstab.yaml, README files, and git remote URLs can be outdated or missing, so all org, site, and repository values come from admin.hlx.page API responses.

What happens if authentication fails during guide generation?▼

The Skill checks for a valid IMS token in ~/.aem/ims-token.json before any API call. If the token is missing or expired, it invokes the auth skill to re-authenticate, then verifies access with a test request to the Config Service before proceeding.