Skip to content

Add Healthcare SEO Metadata agent and validation script - #2

Open
dariank38 wants to merge 1 commit into
jaredcaraway:mainfrom
dariank38:add-seo-agent-and-validator
Open

Add Healthcare SEO Metadata agent and validation script#2
dariank38 wants to merge 1 commit into
jaredcaraway:mainfrom
dariank38:add-seo-agent-and-validator

Conversation

@dariank38

Copy link
Copy Markdown

What this adds

New agent: agents/healthcare-seo-metadata.md (draft status)

Generates SEO metadata — page title, meta description, URL slug, and H1 — for healthcare web pages from pasted copy, a draft, or an outline. It complements the Healthcare Web Content agent by covering the metadata step before Sitecore publication:

  • Deterministic numbered rules with hard character bounds (title <= 60 chars including the Kelsey-Seybold suffix, meta description 120-155) and self-reported character counts in the output.
  • Uses the {PIPE} token convention for the vertical bar in title tags, converted to the literal character only at output time.
  • Same accuracy guardrails as the content agent: no invented statistics or claims, no marketing superlatives, declines out-of-scope work.
  • 4,528 chars of instruction text — well under the 8K Copilot Studio limit.

New script: scripts/validate.py

Run python scripts/validate.py to check every agent in agents/ for:

  1. Instruction text <= 8,000 characters — counts only the ## Instructions section, which is what actually gets pasted into Copilot Studio. wc -c counts the whole file (frontmatter, Purpose section, organizational headings) and over-counts.
  2. Literal | characters (should be {PIPE} — Copilot Studio strips/corrupts pipes).
  3. Markdown tables (not rendered reliably by Copilot Studio).
  4. Frontmatter completeness (name, description, platform, status, created, updated).

All four agents currently pass. CLAUDE.md is updated to point the post-edit check at the validator and document why it replaces wc -c.

- New agent: generates page title, meta description, URL slug, and H1
  for healthcare web pages, with hard character bounds and the {PIPE}
  token convention for Copilot Studio.
- scripts/validate.py: checks every agent for the 8K instruction-text
  limit (counting only the instruction section, unlike wc -c which
  over-counts frontmatter and organizational headings), literal pipe
  characters, markdown tables, and frontmatter completeness.
- CLAUDE.md: point the post-edit check at the validator and document
  why it replaces wc -c.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant