AgentMarkup

View saved version →

---
name: agentmarkup
description: Install, configure, audit, and fix AgentMarkup machine-readable website metadata in JavaScript web repos. Use when adding @agentmarkup/vite, @agentmarkup/astro, @agentmarkup/next, @agentmarkup/nuxt, @agentmarkup/cli, @agentmarkup/audit, or @agentmarkup/core; configuring llms.txt, llms-full.txt, JSON-LD, markdown mirrors, AI crawler robots.txt, Content-Signal headers, or A2A Agent Cards; or auditing and repairing generated output for deployed sites.
license: MIT
metadata:
  compatibility: Requires a JavaScript or TypeScript web repository with package-manager and build access. Network access is useful for package install and deployed-site audits. On surfaces without a shell or repository, this skill advises and drafts config instead of installing.
---

# AgentMarkup

## Overview

Use this skill to add AgentMarkup to an existing web repository, configure it from the user's preferences, audit the generated metadata, and implement fixes until the repo or deployed site has a coherent machine-readable surface.

AgentMarkup can generate or validate `llms.txt`, optional `llms-full.txt`, JSON-LD, markdown mirrors, AI crawler `robots.txt` rules, `_headers`/Content-Signal headers, and optional A2A Agent Card discovery.

## Compatibility

Best used in JavaScript or TypeScript web repositories where you can inspect source files, install dev dependencies, run the normal build, and read generated output.

**Without a shell or a repository** (for example a plain chat surface), steps 1 and 5 through 9 below are not possible. Do not narrate an installation you cannot perform. Instead: read what the user pastes or links, identify the final-HTML owner, recommend the package, and write out the config and the `llms.txt` / JSON-LD they should apply themselves. Say plainly that they need to run the install and build in their own environment.

## Workflow

1. Inspect the target repo before editing. This is read-only and needs no approval.
   - Read `package.json`, lockfiles, framework config, build scripts, existing `public/` assets, and generated output if present.
   - Identify the package manager from lockfiles and existing scripts.
   - Note existing `llms.txt`, `robots.txt`, `_headers`, JSON-LD, sitemap, canonical tags, and deployed URL hints.
2. Choose the integration point by final HTML ownership, not by the first build tool in the stack.
   - Read [references/adapter-selection.md](references/adapter-selection.md).
   - `@agentmarkup/vite`, `@agentmarkup/astro`, `@agentmarkup/next`, `@agentmarkup/nuxt`, `@agentmarkup/cli`, or `@agentmarkup/core`, whichever can actually affect the final deployed output.
   - Present the recommendation and say why that layer owns the final HTML.
3. Capture preferences the repo cannot reveal.
   - Read [references/preferences.md](references/preferences.md).
   - Ask only for missing high-impact preferences such as public site URL, crawler policy, Content-Signal policy, markdown mirror preference, `llms-full.txt`, schema priorities, or A2A Agent Card details.
4. **Stop and get explicit approval before changing anything.**
   - This gate covers all of: installing a package or editing `package.json`/the lockfile, writing or patching config files, running a build, and making an outbound audit request to a deployed site.
   - Present it as **one plan, asked once**: the package to install, every file that would change, the exact commands to run, and the audit target URL if there will be one. Do not ask piecemeal, one permission at a time.
   - If there will be a live audit, name the origin and ask the user to confirm it is a site they own or operate. `@agentmarkup/audit` sends requests from the user's machine under crawler user agents; it is not for pointing at third parties.
   - Do not proceed on silence. If the user declines, stop.
5. After approval, install the selected package with the repo's package manager.
   - `pnpm add -D <package>` when `pnpm-lock.yaml` exists.
   - `npm ins

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 10 — file references are metadata, not package contents.