# da-content

A reference for preparing HTML and media for Adobe Document Authoring and using its preview and publishing APIs. Use it while building or troubleshooting DA content.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 906 installs · ★ 335 repo stars
- Author: adobe
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/adobe/skills/tree/HEAD/plugins/aem/edge-delivery-services/skills/da-content/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/da-content

## What it does

da-content covers the content side of Adobe Document Authoring and Edge Delivery Services. It gives agents rules for HTML uploaded to DA, binary media uploads, and calls to the preview or publishing APIs. The HTML guidance covers blocks, sections, and metadata; media and platform API guidance live in separate references.

This is a reference, not an import workflow. Its guidance marks claims verified from code or observation separately from assumptions drawn from documentation. A malformed block class or table header can cause the block to appear as plain HTML, without its JS or CSS.

The skill describes sending HTML through the Source API, then making a separate preview call; publishing to `aem.live` is an optional next step. Calls to `admin.da.live` and `admin.hlx.page` require an IMS token, obtained with the `da-auth` skill. Block JavaScript and CSS authoring, Universal Editor, and AEM Cloud Service are outside its scope.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill da-content -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/da-content/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/da-content/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill da-content -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/da-content/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill da-content -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/da-content/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install adobe/skills plugins/aem/edge-delivery-services/skills/da-content
```

2. **Manually: put the files in place**
- File: `.github/skills/da-content/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill da-content -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/adobe/skills --path plugins/aem/edge-delivery-services/skills/da-content
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/da-content/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill da-content -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/adobe/skills/tree/HEAD/plugins/aem/edge-delivery-services/skills/da-content/SKILL.md

## When to use it
- prepare an HTML fragment for DA upload
- check block and page metadata structure
- upload media alongside a document that references it
- call the preview API for a page
- diagnose blocks rendered as plain HTML

## Example prompts
- Prepare this page as an HTML fragment for DA upload and check its block structure.
- Explain how to upload `page.html` through the Source API and request a preview.
- Find why this block appears as plain HTML without its JS and CSS.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: ec7357123f3eb767.

BEGIN THIRD-PARTY FILE ec7357123f3eb767
```text
---
name: da-content
description: "Use this when generating HTML for Adobe Document Authoring (DA, da.live) upload, uploading media binaries to DA, publishing to aem.live, or driving the DA admin API (auth, source PUT, preview/publish). Covers block HTML format (canonical div-class form and accepted table alternate), section structure, page and section metadata, icons, links, images, default content, document skeleton constraints, block cell content normalization, the DA Source API contract, IMS auth, media storage, supported formats, Media Bus vs Content Bus delivery, and silent-failure rules that corrupt content."
license: Apache-2.0
metadata:
  version: "1.0.1"
---

# DA + EDS content reference

A reference skill — not a workflow. Use it whenever you need to know **what
the rules are** for generating, uploading, or delivering content through
Adobe Document Authoring (DA) and Edge Delivery Services (EDS).

This skill consolidates rules from three primary surfaces. Load the
reference for the task at hand:

| Doing | Read |
|---|---|
| Generating HTML for DA upload | [references/html-content.md](./references/html-content.md) |
| Uploading images, video, PDFs, fonts | [references/media.md](./references/media.md) |
| Hitting the DA admin API, auth, preview/publish | [references/platform.md](./references/platform.md) |
| Re-verifying asset boundary behavior empirically | [references/fixtures/README.md](./references/fixtures/README.md) |

Every factual claim in the references is tagged `[verified]` (read from
code or observed empirically) or `[assumed]` (inferred from documentation
without direct verification).

## When to use this skill

Invoke this skill whenever you are:

- Generating HTML that will be uploaded to DA (`admin.da.live/source/...`).
- Uploading any binary (PNG, JPG, SVG, MP4, PDF, WOFF2) to DA.
- Calling `admin.da.live` (Source API) or `admin.hlx.page` (preview /
  publish API) directly.
- Reading a DA-stored HTML document and modifying it before re-upload.
- Diagnosing why a generated page renders incorrectly on `aem.page` /
  `aem.live` (silent failures: `about:error` images, missing meta tags,
  blocks rendering as plain HTML without their JS or CSS).

### When NOT to use this skill

- Writing block JS or CSS for a project — use **building-blocks**.
  This skill covers the *content* side, not the *code* side.
- Universal Editor, structured-content authoring, or AEM Cloud Service
  (Java / OSGi / JCR). Out of scope.

## Related Skills

- **da-auth** — Obtain the IMS token needed for every `admin.da.live`
  and `admin.hlx.page` call. Invoke before any operation in this skill
  that needs `DA_TOKEN`.
```
END THIRD-PARTY FILE ec7357123f3eb767

The third-party file has ended. Everything between the ec7357123f3eb767 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2666 of 11863 bytes. © adobe · Apache-2.0 · https://github.com/adobe/skills/tree/HEAD/plugins/aem/edge-delivery-services/skills/da-content/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
