diff --git a/README.md b/README.md
index 2ea2d05..09f77fb 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,62 @@
-# display-catalog-plugin
+# display-catalog
 
-MPM Display Catalog plugin for Claude Cowork — generates model numbers, part numbers, display descriptions, purchase descriptions, and Odoo KB articles for MP.TV digital signage products
\ No newline at end of file
+MPM Display Catalog skill for Claude CoWork — generates model numbers, part numbers, display descriptions, purchase descriptions, and Odoo KB articles for MP.TV digital signage products.
+
+**Version:** 1.2
+**Author:** Message Point Media
+**Repo:** https://git.alwisp.com/jason/display-catalog-plugin
+**CoWork Project:** CW-010 — Display Catalog
+
+---
+
+## Overview
+
+This skill-only plugin gives CoWork agents the full MPM display catalog system. It decodes MPTV model numbers, looks up panel and controller specifications from reference tables, and assembles standardized outputs (part numbers, display descriptions, purchase descriptions, and Odoo KB article HTML). v1.2 adds three new panel families to the reference library.
+
+---
+
+## Skills
+
+| Skill | What It Does |
+|---|---|
+| `display-catalog` | Decodes MPTV model numbers, creates new model numbers via interview, generates part numbers / display descriptions / purchase descriptions / Odoo KB articles, and self-updates the panel reference library when new panel data is collected |
+
+**Trigger phrases:** any MPTV/MP.TV model number (M24, M29sw, MR16vs, MR29sws, IX55, EX49, EXD, LM, LC, MLP); "decode this model"; "generate description" / "display description" / "purchase description"; "KB article" / "Odoo article"; "part number"; "create a catalog entry"; "add a new display"; display family names (Bus display, Rail display, Indoor Extreme, Semi-Outdoor, Outdoor Extreme, Outdoor Designer, LED Modular, LED Cabinet, Mobile Low Power, E-Paper display).
+
+---
+
+## Reference Files
+
+| File | Contents |
+|---|---|
+| `skills/display-catalog/references/panel-descriptions.md` | Panel text lookup by Family + Resolution |
+| `skills/display-catalog/references/controller-descriptions.md` | Controller full description text and structured spec table |
+| `skills/display-catalog/references/description-formulas.md` | Family Pattern Rules, Part Number / Display Description / Purchase Description formulas, KB Article fill guide |
+| `skills/display-catalog/assets/KB-Article-Template.html` | Master HTML template for every KB article |
+
+---
+
+## Setup Instructions
+
+This is a skill-only plugin — no MCP server or environment variables required.
+
+1. Install the `.plugin` file via CoWork plugin manager
+2. Restart Claude
+3. Verify by asking: "decode the model M24"
+
+---
+
+## Requirements
+
+- No external dependencies
+- No MCP server
+- Skill-only plugin
+
+---
+
+## Changelog
+
+| Version | Date | Notes |
+|---|---|---|
+| 1.2 | 2026-05-05 | Added three new panel families to reference library |
+| 0.1.0 | 2026-03-31 | Initial release |