# ForgeLearn — HTML Documentation Index for AI Agents

> HTML curriculum, references, and markdown API entry points for learning and generating correct, accessible, semantic HTML.

## Permanent agent connection

- Connect: https://forgelearn.dev/api/agent
- HTML skill: https://forgelearn.dev/api/agent?skill=forgelearn-html
- Ordered curriculum: https://forgelearn.dev/api/agent?curriculum=html
- Skill file: https://forgelearn.dev/skills/forgelearn-html/SKILL.md
- Platform skill: https://forgelearn.dev/skills/forgelearn/SKILL.md
- Docs: https://forgelearn.dev/docs/agents
- Discovery: https://forgelearn.dev/.well-known/agent.json

```bash
curl -s https://forgelearn.dev/api/agent
curl -s https://forgelearn.dev/api/agent?curriculum=html
curl -s "https://forgelearn.dev/api/markdown?path=html/mastery"
curl -s https://forgelearn.dev/skills/forgelearn-html/SKILL.md -o SKILL.md
```

## Start here (mastery)

- [How to Master HTML](https://forgelearn.dev/docs/html/mastery): Dual-audience curriculum for humans and AI agents — stages, checkpoints, verification prompts
- Markdown: https://forgelearn.dev/api/markdown?path=html/mastery
- [HTML Roadmap](https://forgelearn.dev/docs/roadmaps/html): 49 topics from HTML mastery curriculum to production
- Section bundle: https://forgelearn.dev/api/markdown?section=html
- Tag encyclopedia: https://forgelearn.dev/api/markdown?path=html/tags

## How agents should ingest

1. Connect permanently: `GET /api/agent` (bookmark this)
2. Install skill: fetch `/skills/forgelearn-html/SKILL.md`
3. Fetch ordered curriculum: `/api/agent?curriculum=html`
4. Fetch the mastery page markdown: `/api/markdown?path=html/mastery`
5. Follow Stages 0–7 in order (see mastery curriculum)
6. For each topic: GET `/api/markdown?path=html/<topic>` (or `?format=md` / `Accept: text/markdown`)
7. Tag-by-tag depth: `/api/markdown?path=html/tags`
8. Bulk ingest entire HTML track: `/api/markdown?section=html`
9. Self-verify with generation tasks after each stage — do not claim mastery from outlines alone
10. List all paths: `/api/markdown?list=true`

## Core HTML docs

- [Getting Started](https://forgelearn.dev/docs/html)
- [Document Structure](https://forgelearn.dev/docs/html/structure)
- [Head Elements & Meta](https://forgelearn.dev/docs/html/head)
- [Elements](https://forgelearn.dev/docs/html/elements)
- [Complete Tag Reference](https://forgelearn.dev/docs/html/tags)
- [Attributes](https://forgelearn.dev/docs/html/attributes)
- [Entities](https://forgelearn.dev/docs/html/entities)
- [Headings](https://forgelearn.dev/docs/html/headings)
- [Text Formatting](https://forgelearn.dev/docs/html/text-formatting)
- [Lists](https://forgelearn.dev/docs/html/lists)
- [Links](https://forgelearn.dev/docs/html/links)
- [Images](https://forgelearn.dev/docs/html/images)
- [Picture](https://forgelearn.dev/docs/html/picture)
- [Tables](https://forgelearn.dev/docs/html/tables)
- [Forms](https://forgelearn.dev/docs/html/forms)
- [Input Types](https://forgelearn.dev/docs/html/input-types)
- [Validation](https://forgelearn.dev/docs/html/validation)
- [Buttons](https://forgelearn.dev/docs/html/buttons)
- [Forms API](https://forgelearn.dev/docs/html/forms-api)
- [Media](https://forgelearn.dev/docs/html/media)
- [Iframes](https://forgelearn.dev/docs/html/iframes)
- [Semantic HTML](https://forgelearn.dev/docs/html/semantic)
- [Microdata](https://forgelearn.dev/docs/html/microdata)
- [Open Graph](https://forgelearn.dev/docs/html/opengraph)
- [Meta Tags](https://forgelearn.dev/docs/html/meta-tags)
- [i18n](https://forgelearn.dev/docs/html/i18n)
- [Details](https://forgelearn.dev/docs/html/details)
- [Dialog & Popover](https://forgelearn.dev/docs/html/dialog-popover)
- [Canvas](https://forgelearn.dev/docs/html/canvas)
- [SVG](https://forgelearn.dev/docs/html/svg)
- [Web Components](https://forgelearn.dev/docs/html/web-components)
- [Custom Elements](https://forgelearn.dev/docs/html/custom-elements)
- [Shadow DOM](https://forgelearn.dev/docs/html/shadow-dom)
- [Template & Slot](https://forgelearn.dev/docs/html/template-slot)
- [Storage](https://forgelearn.dev/docs/html/storage)
- [History API](https://forgelearn.dev/docs/html/history-api)
- [Geolocation](https://forgelearn.dev/docs/html/geolocation)
- [Drag & Drop](https://forgelearn.dev/docs/html/drag-drop)
- [Web Workers](https://forgelearn.dev/docs/html/web-workers)
- [SSE](https://forgelearn.dev/docs/html/sse)
- [Accessibility](https://forgelearn.dev/docs/html/accessibility)
- [Performance](https://forgelearn.dev/docs/html/performance)
- [Security](https://forgelearn.dev/docs/html/security)
- [Spec](https://forgelearn.dev/docs/html/spec)
- [HTML Parsing & the DOM Tree](https://forgelearn.dev/docs/html/parsing)
- [Contenteditable & Rich Text](https://forgelearn.dev/docs/html/contenteditable)
- [Best Practices](https://forgelearn.dev/docs/html/best-practices)

## Related indexes

- https://forgelearn.dev/llms.txt
- https://forgelearn.dev/llms-full.txt
- https://forgelearn.dev/api/agent
- https://forgelearn.dev/docs/agents
- https://forgelearn.dev/api/markdown?list=true
- https://forgelearn.dev/api/markdown?section=html
- https://forgelearn.dev/skills/forgelearn-html/SKILL.md