Skip to content

docs(skills): improve reference navigation and context hygiene - #10

Merged
sent-dm merged 1 commit into
mainfrom
codex/reference-navigation-provenance
Aug 9, 2026
Merged

docs(skills): improve reference navigation and context hygiene#10
sent-dm merged 1 commit into
mainfrom
codex/reference-navigation-provenance

Conversation

@sent-dm

@sent-dm sent-dm commented Aug 9, 2026

Copy link
Copy Markdown
Collaborator

What changed

  • Added complete linked TOCs to both canonical references over 100 lines.
  • Added validator coverage for required TOCs, every internal anchor, skill-local bundled paths, one-H1 reference structure, and deprecated Suggested bundled... titles.
  • Removed the MDR skill body's Unverified claims audit section.
  • Moved necessary caveats and provenance into reference-level source notes.
  • Added schemas/sent/documentation-sources.json with URL, kind, affected skills, and last_verified metadata for the freshness monitor.
  • Added source-catalog contract tests and five new rejection gates.

Why

Long references were difficult to navigate, anchor drift was unchecked, and provenance caveats were loaded in the core workflow instead of living with the detailed claims they qualify.

Validation

  • python3 scripts/generate_adapters.py --check
  • python3 scripts/validate.py
  • python3 scripts/test_fixtures.py
  • python3 scripts/test_contracts.py
  • python3 scripts/test_validation_gates.py
  • Agent Skills validation for all canonical skills
  • Strict Claude marketplace and plugin validation
  • git diff --check

Stacked on the discovery metadata PR.

@sent-dm
sent-dm changed the base branch from codex/skill-marketplace-discovery to main August 9, 2026 22:22
@sent-dm
sent-dm marked this pull request as ready for review August 9, 2026 22:22
@sent-dm
sent-dm merged commit 0552bc5 into main Aug 9, 2026
2 checks passed
@sent-dm
sent-dm deleted the codex/reference-navigation-provenance branch August 9, 2026 22:24
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