docs: add agent-assisted import & adapt section to packaging-imports guide#24397
Merged
docs: add agent-assisted import & adapt section to packaging-imports guide#24397
Conversation
Convert packaging-imports.md to .mdx and add a new "Using an Agent to Import and Adapt a Workflow" section. The section follows the same prompt style as the Creating Workflows page, with tabbed examples for the GitHub Web Interface and a step-by-step coding agent workflow. All prompts include repository initialization via install.md since the repo is assumed to be uninitialised. Agent-Logs-Url: https://github.com/github/gh-aw/sessions/76c6bcbf-0914-44ea-9d1a-d671466ad8a6 Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot created this pull request from a session on behalf of
pelikhan
April 3, 2026 23:12
View session
pelikhan
approved these changes
Apr 3, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Updates documentation to describe how to use a coding agent (or GitHub web Copilot) to import an existing workflow from another repository and adapt it in a new/uninitialized repo, and refreshes the Agent Factory status page schedules.
Changes:
- Convert the packaging imports guide to MDX to use Starlight
<Tabs>and add a new “Using an Agent to Import and Adapt a Workflow” section with prompt templates. - Add tabbed GitHub web prompts (Daily Status Report / Issue Triage / CI Doctor) and a generic “Coding Agent” step-by-step template.
- Update the Agent Factory status table with revised schedule strings and add entries for token optimizer/usage analyzer workflows.
Show a summary per file
| File | Description |
|---|---|
| docs/src/content/docs/guides/packaging-imports.mdx | Adds an agent-assisted import/adapt section and prompt templates using Starlight Tabs. |
| docs/src/content/docs/agent-factory-status.mdx | Updates workflow schedule strings and adds new workflow rows to the status table. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comments suppressed due to low confidence (2)
docs/src/content/docs/guides/packaging-imports.mdx:82
- The “Issue Triage” tab prompt asks the agent to “find a suitable issue triage workflow in github/gh-aw” but doesn’t provide a concrete source URL/path. Since gh-aw’s workflow specs live under
.github/workflows/(notworkflows/), this prompt is ambiguous and may send users searching the wrong location. Consider pointing to a specific workflow (e.g.,.../blob/main/.github/workflows/issue-triage-agent.mdorauto-triage-issues.md) to make the example immediately actionable and consistent with the other tabs.
This issue also appears on line 103 of the same file.
docs/src/content/docs/guides/packaging-imports.mdx:110
- The generic prompt template hard-codes the source location as
.../blob/main/workflows/SOURCE_WORKFLOW.md, but many repos (including this one) store workflow specs under.github/workflows/. This can lead to broken URLs and confusion when users follow the template. Consider changing the placeholders to include aPATH(e.g.,PATH/TO/WORKFLOW.md) or explicitly call out both common locations (workflows/and.github/workflows/) in the template text.
- Files reviewed: 2/2 changed files
- Comments generated: 0
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.
The packaging-imports guide covered
gh aw add/gh aw add-wizardbut had no guidance for using a coding agent to import and heavily customize a workflow from another repo in an uninitialised repository.Changes
packaging-imports.md→.mdx— renamed to enable the<Tabs>Starlight componentinstall.mdinitialization since the repo is assumed uninitialisedSOURCE_WORKFLOW/OWNER/REPOprompt template, matching the style ofcreating-workflows.mdxPrompt style mirrors
creating-workflows.mdx:install.mdURL for init, then an adapt instruction with concrete source URL and customization guidance.