feat: add AGENTS.md, rebuild GitHub Pages with fixed template

Add AGENTS.md with repo structure, skills, rules, MCP tools, and CI docs.
Rebuild docs site with fixed skill parser and QoL features (collapsible
categories, search/filter, back-to-top, toast, mobile nav).

Made-with: Cursor

Author: TMHSDigital

AGENTS.md

@@ -0,0 +1,91 @@
+# AGENTS.md
+
+Guidance for AI coding agents working on the Docker Developer Tools repository.
+
+## Repository overview
+
+A Cursor IDE plugin providing Docker and container workflows. 17 skills, 10 rules, and 150 MCP tools for building, debugging, optimizing, and managing Docker containers, images, networks, and volumes. Includes a companion MCP server (`@tmhs/docker-mcp`) for live Docker CLI integration.
+
+**Docs site:** https://tmhsdigital.github.io/Docker-Developer-Tools/
+
+## Repository structure
+
+```
+Docker-Developer-Tools/
+  .cursor-plugin/plugin.json   # Plugin manifest (name, version, description)
+  skills/                      # 17 skill directories, each with SKILL.md
+  rules/                       # 10 rule files (.mdc)
+  mcp-server/                  # Companion MCP server (Node.js/TypeScript)
+    src/                       # Server source code
+    dist/                      # Compiled output
+  mcp-tools.json               # MCP tool catalog (150 tools, manually maintained)
+  site.json                    # GitHub Pages branding/config
+  docs/                        # Generated GitHub Pages site (do not edit manually)
+  assets/                      # Logo and images
+  tests/                       # Test suite
+  .github/workflows/           # CI/CD (ci, codeql, dep-review, links, pages, publish, release-drafter, stale, validate)
+```
+
+## Branching and commit model
+
+- **Single branch:** `main` only
+- **Conventional commits:** `feat:`, `fix:`, `chore:`, `docs:`
+
+## Skills
+
+Each skill lives in `skills/<skill-name>/SKILL.md`. Every SKILL.md starts with YAML frontmatter:
+
+```yaml
+---
+name: skill-name
+description: One-line description of what the skill does
+---
+```
+
+The `name` and `description` fields are parsed by the site template build system to generate the GitHub Pages site. The body below the frontmatter contains the full skill content.
+
+When adding a new skill:
+1. Create `skills/<skill-name>/SKILL.md` with frontmatter
+2. Update the `skills` count in `.cursor-plugin/plugin.json`
+3. Use `feat:` commit prefix
+
+## Rules
+
+Rules are `.mdc` files in `rules/`. Each starts with YAML frontmatter containing `description` and `globs` fields. When adding a new rule, update the `rules` count in context references.
+
+## MCP Tools
+
+`mcp-tools.json` is a manually maintained JSON array of all MCP tools. Each entry has `name`, `description`, and `category` fields. This file is used by the GitHub Pages build system to render the tools catalog. When adding or removing tools from `mcp-server/`, update this file accordingly.
+
+## GitHub Pages
+
+The docs site is auto-generated. Do not edit `docs/index.html` directly. It is built by the shared template system from the Developer-Tools-Directory repo.
+
+Data sources:
+- `.cursor-plugin/plugin.json` -- metadata (name, version, description)
+- `site.json` -- branding (accent color, install steps, links)
+- `skills/*/SKILL.md` -- parsed for name/description via frontmatter
+- `rules/*.mdc` -- parsed for name/scope/description
+- `mcp-tools.json` -- tool catalog
+
+The `pages.yml` workflow clones Developer-Tools-Directory, runs `build_site.py`, and deploys the output. Changes to skills, rules, mcp-tools.json, site.json, plugin.json, or assets trigger a rebuild.
+
+## CI/CD workflows
+
+- `ci.yml` -- runs tests on push/PR
+- `validate.yml` -- validates plugin.json schema, checks docs
+- `pages.yml` -- builds and deploys GitHub Pages via shared template
+- `publish.yml` -- publishes MCP server to npm
+- `codeql.yml` -- security scanning
+- `dependency-review.yml` -- audits PR dependencies
+- `release-drafter.yml` -- auto-drafts release notes
+- `stale.yml` -- marks/closes inactive issues and PRs
+- `links.yml` -- checks for broken links
+
+## Key conventions
+
+- No em dashes or en dashes -- use hyphens or rewrite
+- No hardcoded credentials, tokens, or API keys
+- Conventional commits required
+- CC-BY-NC-ND-4.0 license
+- All content written for public readership