[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
Conversation
…, 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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Refreshes the
skills/github-agentic-workflowsskill 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.mdSource:
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:andtoolsets:but gave no pointer to the official reference for which toolsets expose which operations. Added a sentence after the frontmatter list directing agents toreference/github-tools/when selecting a minimaltoolsets:set.2. Official
github-agentic-workflows.mdagent file URL added toreferences/authoring.mdSource:
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.mdSources:
https://github.github.com/gh-aw/guides/ai-issue-triage/— IssueOps guidehttps://github.github.com/gh-aw/guides/docs-automation/— Continuous Documentation guidehttps://github.github.com/gh-aw/guides/automated-pr-review/— Quality/PR review guidehttps://github.github.com/gh-aw/guides/ai-release-notes/— ProjectOps/release-notes guidehttps://github.github.com/gh-aw/examples/multi-repo/— Multi-repository coordination exampleAll 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.pypasses (SUCCESS)Unresolved Risks
reference/github-tools/, specific guide content,github-agentic-workflows.mdbody) 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.