[workflow-editor] Fix broken heading references to shared snippet-validation procedure
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 85/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Domain
- documentation
Research direction
The issue is about fixing broken heading references in three markdown files: .github/workflows/side-quest.md, security-side-quest.md, and workshop-skill-activity-author.md. They currently point to '### 5. Validate agentic workflow snippets' in workshop-author.md, but the correct heading is '### Validate agentic workflow snippets'. Open each file, find the reference, and update it to match the actual heading. After editing, run 'gh aw compile --validate' to regenerate the corresponding .lock.yml files. Verify the changes by checking that the links resolve correctly.
Written by the indexing model from the issue text.
Description
[!CAUTION]
Protected files were modified in this change.
This pull request is inrequest_reviewmode and requires explicit human scrutiny before merge.Protected files:
.github/workflows/security-side-quest.lock.yml,.github/workflows/security-side-quest.md,.github/workflows/side-quest.lock.yml,.github/workflows/side-quest.md,.github/workflows/workshop-skill-activity-author.lock.yml,.github/workflows/workshop-skill-activity-author.md
Removes a small piece of broken duplication: three workflow files
(side-quest.md, security-side-quest.md,
workshop-skill-activity-author.md) each pointed learners/agents to a
shared procedure at ### 5. Validate agentic workflow snippets inside
workshop-author.md — but that section is titled ### Validate agentic workflow snippets (no number prefix, and it isn't the fifth heading in
the file). The stale numbered reference was likely left over from an
earlier version of workshop-author.md that has since been reorganized.
Files changed
.github/workflows/side-quest.md.github/workflows/security-side-quest.md.github/workflows/workshop-skill-activity-author.md- Regenerated
.lock.ymlfiles for all three viagh aw compile --validate
Why this is more Skills-like
The fix keeps the "shared procedure" cross-reference pattern (short,
DRY, one canonical source of truth in workshop-author.md) but makes
the pointer actually resolve, so an agent or learner following the link
lands on the right section instead of a numbered heading that doesn't
exist. No behavior, trigger, permission, or safe-output changes — this
is a pure accuracy fix to existing shared guidance text.
[!WARNING]
Firewall blocked 1 domain
The following domain was blocked by the firewall during workflow execution:
api.github.com[!TIP]
api.github.comis blocked because GitHub API access uses the built-in GitHub tools by default. Instead of addingapi.github.comtonetwork.allowed, usetools.github.mode: gh-proxyfor direct pre-authenticated GitHub CLI access without requiring network access toapi.github.com:tools: github: mode: gh-proxySee GitHub Tools for more information on
gh-proxymode.To allow these domains, add them to the
network.allowedlist in your workflow frontmatter:network: allowed: - defaults - "api.github.com"See Network Configuration for more information.
Generated by ✂️ Workflow Skills Editor · copilot · auto · 38.6 AIC · ⌖ 8.71 AIC · ⊞ 7.5K · ◷
- expires on Sep 25, 2026, 7:38 AM UTC
[!NOTE]
This was originally intended as a pull request, but the git push operation failed.Original error: The process '/usr/bin/git' failed with exit code 1
Workflow Run: View run details and download bundle artifact
The bundle file is available in the
agentartifact in the workflow run linked above.
Create the pull request manually
# Download the artifact from the workflow run
gh run download '35970180586' -n agent -D '/tmp/agent-35970180586'
# Resolve the bundle source ref, fetch it into a temporary ref, then create the local branch
bundle_path='/tmp/agent-35970180586/aw-fix-workshop-author-snippet-heading-ref.bundle'
temp_ref='refs/bundles/create-pr-fix-workshop-author-snippet-heading-ref-14d0d19d5332017c-bd2a05ad'
target_ref='refs/heads/fix/workshop-author-snippet-heading-ref-14d0d19d5332017c'
bundle_source_ref=$(git bundle list-heads "$bundle_path" | awk '$2 ~ /^refs\/heads\// { print $2 }')
if [ -z "$bundle_source_ref" ]; then
bundle_source_ref=$(git bundle list-heads "$bundle_path" | awk '$2 == "HEAD" { print $2 }')
fi
if [ "$(printf '%s\n' "$bundle_source_ref" | sed '/^$/d' | wc -l | tr -d ' ')" != "1" ]; then
echo "Expected exactly one bundle source ref, found: $bundle_source_ref" >&2
exit 1
fi
git fetch "$bundle_path" "${bundle_source_ref}:${temp_ref}"
git update-ref "$target_ref" "$temp_ref"
git checkout 'fix/workshop-author-snippet-heading-ref-14d0d19d5332017c'
# Ensure the working tree matches the updated branch
git reset --hard
# Remove the temporary bundle ref
git update-ref -d "$temp_ref"
# Push the branch to the target remote
git push 'origin' 'fix/workshop-author-snippet-heading-ref-14d0d19d5332017c'
# Create the pull request
gh pr create --title '[workflow-editor] Fix broken heading references to shared snippet-validation procedure' --base 'main' --head 'fix/workshop-author-snippet-heading-ref-14d0d19d5332017c' --repo 'githubnext/gh-aw-workshop'
- Dominant language
- JavaScript
- Stars
- 49
- Forks
- 20
- Avg merge
- 8h 51m
- Merged PRs (30d)
- 38
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from githubnext/gh-aw-workshop
-
feedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
githubnext/gh-aw-workshop#3775 ·
-
feedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
githubnext/gh-aw-workshop#3774 ·
-
feedback simulation workshop
Difficulty 1/5 Under an hour Newbie friendliness 85/100
githubnext/gh-aw-workshop#3773 ·
-
feedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
githubnext/gh-aw-workshop#3772 ·
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
githubnext/gh-aw-workshop#3769 ·
All issues in githubnext/gh-aw-workshop
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
area-deployment area-integrations triage:bot-seen
Difficulty 2/5 Half a day Newbie friendliness 86/100
-
Issue-Bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
sugarlabs/musicblocks#8924 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
ArduPilot/ardupilot_wiki#8088 ·
-
[BUG] createTool tools cannot be registered with Mastra when exactOptionalPropertyTypes is enabled Opencustomer-eng status: needs triage
Difficulty 2/5 1-3 hours Newbie friendliness 84/100