[workflow-editor] docs-linker: merge redundant Verify Concept Coverage section

[github-actions]

Caution

Protected files were modified in this change.
This pull request is in request_review mode and requires explicit human scrutiny before merge.

Protected files: .github/workflows/docs-linker.lock.yml, .github/workflows/docs-linker.md

What changed

.github/workflows/docs-linker.md had a standalone ## Verify Concept Coverage (Doc Index Check) section that restated validation rules already present in ## Identify Concepts and Tasks. The anchor-text and page-title validation rules were also only applied to the "top 3–5 most prominent" matches instead of every match during URL resolution.

What was removed

The separate ## Verify Concept Coverage (Doc Index Check) section (13 lines: heading, intro, two bullet rules, and surrounding dividers) has been deleted.

Where the rules now live

Both validation rules are folded inline into the URL-resolution steps in ## Identify Concepts and Tasks:

• Anchor validation added to step 2: "The anchor's text field must contain at least one word from the concept term; discard candidates that do not."
• Page-title validation added to step 4: "The page title must be topically related to the concept; discard obviously mismatched entries."

Validation now applies consistently to every mapping entry, not just the top few — more correct and more concise.

Why this is more Skills-like

GitHub Skills content is direct and outcome-focused. Restating a quality gate as a separate section after the steps it governs adds scanning overhead. Merging it inline keeps the procedure compact and the rules co-located with where they apply.

Files changed

• .github/workflows/docs-linker.md — merged sections, net −10 lines
• .github/workflows/docs-linker.lock.yml — regenerated with gh aw compile --validate

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by ✂️ Workflow Skills Editor · 64.5 AIC · ⌖ 8.48 AIC · ⊞ 5.1K · ◷

• expires on Aug 16, 2026, 9:38 PM UTC

---

Note

This was originally intended as a pull request, but the git push operation failed.

Original error: pushSignedCommits: refusing unsigned push for branch 'workflow-skills-editor/merge-verify-concept-section-91af197f08ba66f8': Signed-commit payload violates file-protection policy (request_review): .github/workflows/docs-linker.lock.yml, .github/workflows/docs-linker.md

Workflow Run: View run details and download bundle artifact

The bundle file is available in the agent artifact in the workflow run linked above.

To create a pull request with the changes:

# Download the artifact from the workflow run
gh run download 31909560027 -n agent -D /tmp/agent-31909560027

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-31909560027/aw-workflow-skills-editor-merge-verify-concept-section.bundle refs/heads/workflow-skills-editor/merge-verify-concept-section:refs/bundles/create-pr-workflow-skills-editor-merge-verify-concept-section-91af197f08ba66f8-5ee993bf
git update-ref refs/heads/workflow-skills-editor/merge-verify-concept-section-91af197f08ba66f8 refs/bundles/create-pr-workflow-skills-editor-merge-verify-concept-section-91af197f08ba66f8-5ee993bf
git checkout workflow-skills-editor/merge-verify-concept-section-91af197f08ba66f8
# Ensure the working tree matches the updated branch
git reset --hard
# Remove the temporary bundle ref
git update-ref -d refs/bundles/create-pr-workflow-skills-editor-merge-verify-concept-section-91af197f08ba66f8-5ee993bf

# Push the branch to origin
git push origin workflow-skills-editor/merge-verify-concept-section-91af197f08ba66f8

# Create the pull request
gh pr create --title '[workflow-editor] docs-linker: merge redundant Verify Concept Coverage section' --base main --head workflow-skills-editor/merge-verify-concept-section-91af197f08ba66f8 --repo githubnext/gh-aw-workshop