ensure-agents-md

Create AGENTS.md and CLAUDE.md for AEM Cloud Service projects.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/adobe/aem-auth-demo --skill ensure-agents-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ensure-agents-md
Source: https://github.com/adobe/aem-auth-demo/tree/main/.agents/skills/ensure-agents-md
Command: npx skills add https://github.com/adobe/aem-auth-demo --skill ensure-agents-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstraps essential project guidance by creating AGENTS.md and CLAUDE.md at the repository root when AGENTS.md is missing, ensuring AI agents have a starting point for Cloud Service projects.

Core Features & Use Cases

  • Creates AGENTS.md and CLAUDE.md at the workspace root for AEM Cloud Service projects.
  • Performs gate checks to verify the repository is an AEM Cloud Service project and to avoid overwriting existing files.
  • Tailors AGENTS.md content using the project pom.xml and discovered modules for accurate guidance.
  • Maintains a no-overwrite policy, applying on every user request until AGENTS.md exists.

Quick Start

Initialize project guidance by running this skill at the project root when AGENTS.md is missing.

Frequently Asked Questions about ensure-agents-md

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

FAQPage Schema
How do I bootstrap AGENTS.md for an AEM Cloud Service project?

To bootstrap AGENTS.md for an AEM Cloud Service project, the skill validates the repository structure, reads the root pom.xml, discovers modules, and generates AGENTS.md at the workspace root using a predefined template.

What happens if AGENTS.md already exists in my AEM project?

If AGENTS.md already exists in your AEM project, the skill enforces a no-overwrite policy and skips file generation, ensuring your existing project guidance remains completely untouched during subsequent requests.

How does CLAUDE.md integrate with AGENTS.md for project setup?

During project setup, if CLAUDE.md is missing, the skill creates it at the workspace root containing the single line '@AGENTS.md', effectively linking CLAUDE.md to the tailored AGENTS.md guidance file.

How is AGENTS.md content tailored for my specific AEM modules?

AGENTS.md content is tailored by reading the project's root pom.xml and performing module discovery, allowing the generated guidance to accurately reflect the specific structure and modules of your AEM Cloud Service project.

Does this skill work with non-AEM Cloud Service repositories?

No, the skill performs gate checks to validate that the repository is specifically an AEM Cloud Service project by analyzing the pom.xml, and it will not generate AGENTS.md for non-AEM repositories.