Skip to content

feat(agent): add docs migration agent skills and preview verification - #656

Open
alexeagle wants to merge 5 commits into
mainfrom
agent-skills-docs-migration
Open

feat(agent): add docs migration agent skills and preview verification#656
alexeagle wants to merge 5 commits into
mainfrom
agent-skills-docs-migration

Conversation

@alexeagle

@alexeagle alexeagle commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds canonical agent skills under agent-skills/ for coordinating bazel.build migration work (manager + worker roles for bazel.build Migration: Known Issues & Bugs bazelbuild/bazel#30598 and related issues).
  • Adds Mintlify preview verification scripts (scripts/verify_mintlify_preview.mjs, scripts/screenshot_mintlify_preview.sh) for Playwright-based DOM checks on PR preview deployments.
  • Adds AGENTS.md for Codex/Gemini discovery, updates CLAUDE.md and README.md, and symlinks .cursor/skills/ and .claude/skills/ to the canonical skill paths.

Why bazel-docs

This repo owns the Mintlify preview pipeline and sync build. Agent workflows need:

  1. Skills that reference preview URLs, workflow triggers, and verification tooling here.
  2. A single canonical location discoverable by Cursor, Claude Code, and Codex.

Fix PRs still land in bazelbuild/bazel; this PR provides the coordination and verification infrastructure.

Test plan

  • Skills render correctly from agent-skills/ paths
  • Symlinks resolve: .cursor/skills/bazel-docs-migration-manageragent-skills/bazel-docs-migration-manager
  • scripts/screenshot_mintlify_preview.sh is executable
  • Review AGENTS.md and manager skill for accuracy against current preview workflow
  • Optional: run node scripts/verify_mintlify_preview.mjs against a live preview URL (requires Playwright)

Add canonical agent-skills/ for bazel.build migration work (manager +
worker), Playwright verification scripts, AGENTS.md for Codex/Gemini,
and symlinks for Cursor and Claude Code discovery.

Supports coordinated fixes for bazelbuild/bazel#30598 with Mintlify
preview visual verification from this repo.
@mintlify

mintlify Bot commented Aug 13, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
bazel 🟢 Ready View Preview Aug 13, 2026, 2:55 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Remove hard-coded PR→page mappings from screenshot and verify scripts.
Agents pass --path args or a local --checks-file; add example schema only.
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