Skip to content

[skill-update] github-agentic-workflows: add github-tools ref, official guides, and agent authoring file - #27

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
skill-update/github-agentic-workflows-homepage-refs-4d4a76aeaf17f514
Draft

[skill-update] github-agentic-workflows: add github-tools ref, official guides, and agent authoring file#27
github-actions[bot] wants to merge 1 commit into
mainfrom
skill-update/github-agentic-workflows-homepage-refs-4d4a76aeaf17f514

Conversation

@github-actions

@github-actions github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Refreshes the skills/github-agentic-workflows skill from the prefetched gh-aw homepage snapshot (https://github.github.com/gh-aw/), targeting three material gaps not yet covered by the existing skill files.


Material Deltas

1. GitHub tools reference URL added to references/authoring.md

Source: https://github.github.com/gh-aw/reference/github-tools/ — visible as a feature card link on the homepage.

The existing Frontmatter Priorities section describes tools: and toolsets: but gave no pointer to the official reference for which toolsets expose which operations. Added a sentence after the frontmatter list directing agents to reference/github-tools/ when selecting a minimal toolsets: set.

2. Official github-agentic-workflows.md agent file URL added to references/authoring.md

Source: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md — linked from the gh-aw homepage as the canonical authoring guidance file.

The Agentic Authoring Support section previously listed install.md, debug.md, and the workshop, but not this file. It is distinct from the others: it is the machine-readable agent instruction file for GH-AW's own authoring surface, useful when a coding agent needs the canonical form directly.

3. Official guide and example URLs added to references/examples.md

Sources:

All five are directly linked from the homepage navigation/gallery. The Common Production Patterns list previously named the workflow families without pointing to the official guide or example pages. Added inline URLs for five of the nine entries.


Validations Run

  • validate-metadata.py passes (SUCCESS)
  • SKILL.md remains 91 lines (well under 500-line limit)
  • Checklist: naming, directory match, description, no human docs, flat hierarchy all unchanged and still pass

Unresolved Risks

  • The prefetched source is the gh-aw homepage HTML snapshot only (1 file). Secondary reference pages (reference/github-tools/, specific guide content, github-agentic-workflows.md body) were not prefetched, so the new URLs are added as navigation pointers rather than with extracted detail. If any URL changes or the content differs materially from the pointer label, the reference will be stale.
  • No user-supplied prompt text for this run; all changes derive solely from the prefetched homepage source.

Generated by Skill Update Worker · ● 22.6M ·

…, and agent authoring file

- Add reference/github-tools/ URL to authoring.md frontmatter section so agents know
  where to consult the official GitHub toolsets reference when selecting tools:
- Add official github-agentic-workflows.md agent file URL to Agentic Authoring Support
  section in authoring.md (visible on gh-aw homepage, new canonical authoring prompt)
- Add official guide URLs to Common Production Patterns in examples.md:
  ai-issue-triage, docs-automation, automated-pr-review, ai-release-notes, multi-repo

Source: https://github.github.com/gh-aw/ (prefetched as 01.txt)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

0 participants