Skip to content

Promote ELI5 HTML skill rewrite - #155

Merged
lastobelus merged 3 commits into
mainfrom
agent/promote-eli5-html-doc-rewrite
Aug 15, 2026
Merged

Promote ELI5 HTML skill rewrite#155
lastobelus merged 3 commits into
mainfrom
agent/promote-eli5-html-doc-rewrite

Conversation

@lastobelus

Copy link
Copy Markdown
Owner

What changed

  • promote the approved eli5-html-doc rewrite into the canonical skill
  • move diagrams, feedback controls, clickable local links, and icon-only controls behind one optional-surfaces reference
  • add a deterministic verifier for self-containment, path safety, inline JavaScript, and local targets
  • retain the existing experiment history and skill UI metadata unchanged

Why

The skill was already successful in use, but its common path carried detailed rules for infrequent surfaces and agents repeatedly retyped mechanical checks. This rewrite keeps the accepted artifact behavior while reducing common context and making mechanical verification one bounded command.

Boundary

This PR changes only the canonical ELI5 skill. It excludes the rewrite discussion files, existing artifacts, application code, presentation templates, browser dependencies, and compatibility work for historical Dragonlist pages.

Validation

  • skill-creator quick_validate.py
  • promoted files byte-identical to the approved rewrite
  • canonical verifier parses with node --check
  • canonical verifier passes seven current Markover ELI5 artifacts
  • canonical verifier correctly reports the known stale docs/releasing.md reference in the historical signing slice-3 artifact; that content repair is out of scope
  • npm run ci:local — 714/714 tests plus smoke passing
  • git diff --check

@lastobelus

lastobelus commented Aug 15, 2026

Copy link
Copy Markdown
Owner Author

Work intent

phase: completed
summary: "PR #155 merged into main as 29e44b02 after three bounded review rounds and exact-head CI at 58ccc3c."
touch-points:
  - ".agents/skills/eli5-html-doc/SKILL.md"
  - ".agents/skills/eli5-html-doc/references/optional-surfaces.md"
  - ".agents/skills/eli5-html-doc/scripts/verify-eli5.mjs"
done-when: "PR #155 merges the approved skill-only files into main after exact-head validation."
excludes:
  - "discussion files and rewrite history"
  - "existing ELI5 artifacts and their stale links"
  - "application code, presentation templates, browser dependencies, module-script compatibility, srcset data-URL compatibility, and Dragonlist compatibility work"
blocked-by: []
may-block: []
branch: "agent/promote-eli5-html-doc-rewrite"

@lastobelus
lastobelus marked this pull request as ready for review August 15, 2026 19:57
@lastobelus

Copy link
Copy Markdown
Owner Author

@codex review

@lastobelus
lastobelus force-pushed the agent/promote-eli5-html-doc-rewrite branch from 88d3c1b to 03375b7 Compare August 15, 2026 19:58

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 03375b78cf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/skills/eli5-html-doc/scripts/verify-eli5.mjs
Comment thread .agents/skills/eli5-html-doc/scripts/verify-eli5.mjs
@lastobelus

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 51aa4fe189

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/skills/eli5-html-doc/scripts/verify-eli5.mjs Outdated
Comment thread .agents/skills/eli5-html-doc/scripts/verify-eli5.mjs
@lastobelus

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 58ccc3cdfe

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .agents/skills/eli5-html-doc/scripts/verify-eli5.mjs
@lastobelus
lastobelus merged commit 29e44b0 into main Aug 15, 2026
1 check passed
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