Open
Conversation
Add complete Java cookbook matching the pattern of existing .NET, Go, Node.js, and Python cookbooks. All 7 recipes included: - Ralph Loop: Autonomous AI task loops with JBang - Error Handling: try-with-resources, ExecutionException, timeouts - Multiple Sessions: Parallel sessions with CompletableFuture - Managing Local Files: AI-powered file organization - PR Visualization: Interactive PR age charts - Persisting Sessions: Save/resume with custom IDs - Accessibility Report: WCAG reports via Playwright MCP Each recipe includes both markdown documentation and a standalone JBang-runnable Java file in recipe/.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- Replace Thread.sleep with sendAndWait in PRVisualization - Fix top-level statements in multiple-sessions.md (wrap in class) - Fix .getMessage() → .getData().content() in MultipleSessions.java - Guard against null readLine() in AccessibilityReport.java - Add null-safe getCause() + InterruptedException handling in ErrorHandling.java - Fix paths: jbang commands now include recipe/ prefix - Fix root README path: cd java/recipe (not java/cookbook/recipe) - Fix recipe/README.md ralph-loop CLI example
Add Java SDK cookbook with 7 recipes
Fix compilation errors and documentation inaccuracies in Java cookbook recipes against the actual SDK API: - MultipleSessions: Replace non-existent destroy() with close() - AccessibilityReport: Replace non-existent McpServerConfig class with Map<String, Object> (the actual type accepted by setMcpServers) - error-handling.md: Replace non-existent session.addTool(), ToolDefinition.builder(), and ToolResultObject with actual SDK APIs (ToolDefinition.create(), SessionConfig.setTools(), CompletableFuture<Object> return type) All 7 recipes now compile successfully with jbang build. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
fix: Java cookbook recipes to compile with copilot-sdk-java 0.2.1-java.1
…main revert: Remove Java cookbook from main (was merged to wrong branch)
Contributor
🔍 Skill Validator Results118 resource(s) checked | ✅ All checks passed Full output
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds a large set of new plugin skills/agents and reference assets across multiple plugins, and updates multiple plugin manifests. It also adds a new entry to docs/README.skills.md for github-agentic-workflows.
Changes:
- Added many new
SKILL.md/ agent documents and supporting reference assets across multipleplugins/*directories. - Normalized multiple
plugins/*/.github/plugin/plugin.jsonentries (notably removing trailing slashes and, in some plugins, pointingagentsto a directory). - Updated
docs/README.skills.mdto includegithub-agentic-workflows.
Reviewed changes
Copilot reviewed 119 out of 409 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-build/references/trigger-types.md | Adds Power Automate trigger templates reference |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-build/references/flow-schema.md | Documents the flow definition JSON schema |
| plugins/flowstudio-power-automate/skills/flowstudio-power-automate-build/references/build-patterns.md | Adds copy/paste build pattern examples |
| plugins/flowstudio-power-automate/.github/plugin/plugin.json | Updates manifest skill paths |
| plugins/fastah-ip-geo-tools/skills/geofeed-tuner/references/snippets-python3.md | Adds Python snippet reference for IP parsing/validation |
| plugins/fastah-ip-geo-tools/skills/geofeed-tuner/assets/small-territories.json | Adds territory code list asset |
| plugins/fastah-ip-geo-tools/skills/geofeed-tuner/assets/example/01-user-input-rfc8805-feed.csv | Adds example RFC8805 geofeed CSV |
| plugins/fastah-ip-geo-tools/.github/plugin/plugin.json | Updates manifest skill path |
| plugins/edge-ai-tasks/.github/plugin/plugin.json | Changes manifest agents entry to a directory |
| plugins/doublecheck/skills/doublecheck/assets/verification-report-template.md | Adds a verification report template asset |
| plugins/doublecheck/agents/doublecheck.md | Adds a “Doublecheck” verification agent |
| plugins/doublecheck/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill path |
| plugins/devops-oncall/skills/multi-stage-dockerfile/SKILL.md | Adds a multi-stage Dockerfile skill |
| plugins/devops-oncall/agents/azure-principal-architect.md | Adds an Azure principal architect agent document |
| plugins/devops-oncall/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill paths |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-usecase-builder/SKILL.md | Adds Dataverse use-case solution builder skill |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-quickstart/SKILL.md | Adds Dataverse Python quickstart skill |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-production-code/SKILL.md | Adds Dataverse production code patterns skill |
| plugins/dataverse-sdk-for-python/skills/dataverse-python-advanced-patterns/SKILL.md | Adds Dataverse advanced patterns skill |
| plugins/dataverse-sdk-for-python/.github/plugin/plugin.json | Updates manifest skill paths |
| plugins/database-data-management/skills/postgresql-code-review/SKILL.md | Adds a PostgreSQL-specific code review skill |
| plugins/database-data-management/agents/postgresql-dba.md | Adds a PostgreSQL DBA agent document |
| plugins/database-data-management/agents/ms-sql-dba.md | Adds an MS-SQL DBA agent document |
| plugins/database-data-management/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill paths |
| plugins/csharp-mcp-development/skills/csharp-mcp-server-generator/SKILL.md | Adds a C# MCP server generator skill |
| plugins/csharp-mcp-development/agents/csharp-mcp-expert.md | Adds a C# MCP server expert agent document |
| plugins/csharp-mcp-development/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill path |
| plugins/csharp-dotnet-development/skills/dotnet-upgrade/SKILL.md | Adds a .NET upgrade prompt set skill |
| plugins/csharp-dotnet-development/skills/dotnet-best-practices/SKILL.md | Adds .NET best practices skill |
| plugins/csharp-dotnet-development/skills/csharp-xunit/SKILL.md | Adds XUnit best practices skill |
| plugins/csharp-dotnet-development/skills/csharp-tunit/SKILL.md | Adds TUnit best practices skill |
| plugins/csharp-dotnet-development/skills/csharp-nunit/SKILL.md | Adds NUnit best practices skill |
| plugins/csharp-dotnet-development/skills/csharp-async/SKILL.md | Adds C# async best practices skill |
| plugins/csharp-dotnet-development/skills/aspnet-minimal-api-openapi/SKILL.md | Adds ASP.NET Minimal API + OpenAPI skill |
| plugins/csharp-dotnet-development/agents/expert-dotnet-software-engineer.md | Adds an expert .NET engineer agent document |
| plugins/csharp-dotnet-development/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill paths |
| plugins/copilot-sdk/.github/plugin/plugin.json | Updates manifest skill path |
| plugins/context-matic/skills/integrate-context-matic/SKILL.md | Adds a context-matic integration workflow skill |
| plugins/context-matic/.github/plugin/plugin.json | Updates manifest skill paths |
| plugins/context-engineering/skills/what-context-needed/SKILL.md | Adds a “what context is needed” skill |
| plugins/context-engineering/skills/refactor-plan/SKILL.md | Adds a refactor planning skill |
| plugins/context-engineering/skills/context-map/SKILL.md | Adds a context mapping skill |
| plugins/context-engineering/agents/context-architect.md | Adds a context architect agent document |
| plugins/context-engineering/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill paths |
| plugins/clojure-interactive-programming/skills/remember-interactive-programming/SKILL.md | Adds interactive programming reminder skill |
| plugins/clojure-interactive-programming/agents/clojure-interactive-programming.md | Adds Clojure interactive programming agent document |
| plugins/clojure-interactive-programming/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill path |
| plugins/cast-imaging/agents/cast-imaging-structural-quality-advisor.md | Adds CAST Imaging quality advisor agent document |
| plugins/cast-imaging/agents/cast-imaging-software-discovery.md | Adds CAST Imaging discovery agent document |
| plugins/cast-imaging/agents/cast-imaging-impact-analysis.md | Adds CAST Imaging impact analysis agent document |
| plugins/cast-imaging/.github/plugin/plugin.json | Changes manifest agents entry to a directory |
| plugins/azure-cloud-development/skills/azure-pricing/references/SERVICE-NAMES.md | Adds Azure pricing service name reference |
| plugins/azure-cloud-development/skills/azure-pricing/references/REGIONS.md | Adds Azure region mapping reference |
| plugins/azure-cloud-development/skills/azure-pricing/references/COST-ESTIMATOR.md | Adds cost estimation formulas reference |
| plugins/azure-cloud-development/skills/azure-pricing/references/COPILOT-STUDIO-RATES.md | Adds Copilot Studio billing rates snapshot and formulas |
| plugins/azure-cloud-development/skills/azure-pricing/SKILL.md | Adds/updates Azure pricing skill documentation |
| plugins/azure-cloud-development/agents/terraform-azure-planning.md | Adds Terraform planning agent document |
| plugins/azure-cloud-development/agents/terraform-azure-implement.md | Adds Terraform implementation agent document |
| plugins/azure-cloud-development/agents/azure-verified-modules-terraform.md | Adds AVM Terraform agent document |
| plugins/azure-cloud-development/agents/azure-verified-modules-bicep.md | Adds AVM Bicep agent document |
| plugins/azure-cloud-development/agents/azure-saas-architect.md | Adds Azure SaaS architect agent document |
| plugins/azure-cloud-development/agents/azure-principal-architect.md | Adds Azure principal architect agent document |
| plugins/azure-cloud-development/agents/azure-logic-apps-expert.md | Adds Azure Logic Apps expert agent document |
| plugins/azure-cloud-development/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill paths |
| plugins/awesome-copilot/skills/suggest-awesome-github-copilot-skills/SKILL.md | Adds skill suggestion skill |
| plugins/awesome-copilot/skills/suggest-awesome-github-copilot-instructions/SKILL.md | Adds instructions suggestion skill |
| plugins/awesome-copilot/skills/suggest-awesome-github-copilot-agents/SKILL.md | Adds agents suggestion skill |
| plugins/awesome-copilot/agents/meta-agentic-project-scaffold.md | Adds meta scaffold agent document |
| plugins/awesome-copilot/.github/plugin/plugin.json | Changes manifest agents entry to a directory and updates skill paths |
| plugins/automate-this/.github/plugin/plugin.json | Updates manifest skill path |
| plugins/arize-ax/skills/arize-trace/references/ax-setup.md | Adds ax CLI troubleshooting reference |
| plugins/arize-ax/skills/arize-trace/references/ax-profiles.md | Adds ax profile setup reference |
| plugins/arize-ax/skills/arize-prompt-optimization/references/ax-setup.md | Adds ax CLI troubleshooting reference (prompt optimization) |
| plugins/arize-ax/skills/arize-prompt-optimization/references/ax-profiles.md | Adds ax profile setup reference (prompt optimization) |
| plugins/arize-ax/skills/arize-link/references/EXAMPLES.md | Adds Arize deep-link examples |
| plugins/arize-ax/skills/arize-link/SKILL.md | Adds Arize deep-link generation skill |
| plugins/arize-ax/skills/arize-instrumentation/references/ax-profiles.md | Adds ax profile setup reference (instrumentation) |
| plugins/arize-ax/skills/arize-experiment/references/ax-setup.md | Adds ax CLI troubleshooting reference (experiment) |
| plugins/arize-ax/skills/arize-experiment/references/ax-profiles.md | Adds ax profile setup reference (experiment) |
| plugins/arize-ax/skills/arize-evaluator/references/ax-setup.md | Adds ax CLI troubleshooting reference (evaluator) |
| plugins/arize-ax/skills/arize-evaluator/references/ax-profiles.md | Adds ax profile setup reference (evaluator) |
| plugins/arize-ax/skills/arize-dataset/references/ax-setup.md | Adds ax CLI troubleshooting reference (dataset) |
| plugins/arize-ax/skills/arize-dataset/references/ax-profiles.md | Adds ax profile setup reference (dataset) |
| plugins/arize-ax/skills/arize-annotation/references/ax-setup.md | Adds ax CLI troubleshooting reference (annotation) |
| plugins/arize-ax/skills/arize-annotation/references/ax-profiles.md | Adds ax profile setup reference (annotation) |
| plugins/arize-ax/skills/arize-annotation/SKILL.md | Adds annotation config + span annotation skill |
| plugins/arize-ax/skills/arize-ai-provider-integration/references/ax-setup.md | Adds ax CLI troubleshooting reference (AI provider) |
| plugins/arize-ax/skills/arize-ai-provider-integration/references/ax-profiles.md | Adds ax profile setup reference (AI provider) |
| plugins/arize-ax/.github/plugin/plugin.json | Updates manifest skill paths |
| docs/README.skills.md | Adds github-agentic-workflows to skills catalog |
| | [gh-cli](../skills/gh-cli/SKILL.md) | GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line. | None | | ||
| | [git-commit](../skills/git-commit/SKILL.md) | Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping | None | | ||
| | [git-flow-branch-creator](../skills/git-flow-branch-creator/SKILL.md) | Intelligent Git Flow branch creator that analyzes git status/diff and creates appropriate branches following the nvie Git Flow branching model. | None | | ||
| | [github-agentic-workflows](../skills/github-agentic-workflows/SKILL.md) | Create, update, debug, upgrade, and manage GitHub Agentic Workflows (gh-aw). Covers workflow creation with YAML frontmatter and markdown prompts, trigger configuration, safe-outputs, MCP server integration, shared components, security best practices, and compilation. WHEN: create agentic workflow, gh-aw, update workflow, debug workflow, upgrade workflow, compile workflow, safe outputs, workflow triggers, MCP server workflow, shared workflow component, label command, slash command, agentic automation, GitHub Actions AI agent. | None | |
There was a problem hiding this comment.
The PR description says the main change is adding documentation for a new github-agentic-workflows skill, but this PR also introduces many new plugin skills/agents/assets and changes numerous plugin.json manifests. Please either (a) update the PR description to reflect the full scope, or (b) split these changes into separate PRs to keep review/rollback manageable.
| | [gh-cli](../skills/gh-cli/SKILL.md) | GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line. | None | | ||
| | [git-commit](../skills/git-commit/SKILL.md) | Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping | None | | ||
| | [git-flow-branch-creator](../skills/git-flow-branch-creator/SKILL.md) | Intelligent Git Flow branch creator that analyzes git status/diff and creates appropriate branches following the nvie Git Flow branching model. | None | | ||
| | [github-agentic-workflows](../skills/github-agentic-workflows/SKILL.md) | Create, update, debug, upgrade, and manage GitHub Agentic Workflows (gh-aw). Covers workflow creation with YAML frontmatter and markdown prompts, trigger configuration, safe-outputs, MCP server integration, shared components, security best practices, and compilation. WHEN: create agentic workflow, gh-aw, update workflow, debug workflow, upgrade workflow, compile workflow, safe outputs, workflow triggers, MCP server workflow, shared workflow component, label command, slash command, agentic automation, GitHub Actions AI agent. | None | |
There was a problem hiding this comment.
This adds a link to ../skills/github-agentic-workflows/SKILL.md, but that skill file/folder is not included in the provided diff. If it doesn’t already exist on the target branch, the documentation link will be broken—please add the missing skill folder (with SKILL.md) or update the link to the correct location.
Suggested change
| | [github-agentic-workflows](../skills/github-agentic-workflows/SKILL.md) | Create, update, debug, upgrade, and manage GitHub Agentic Workflows (gh-aw). Covers workflow creation with YAML frontmatter and markdown prompts, trigger configuration, safe-outputs, MCP server integration, shared components, security best practices, and compilation. WHEN: create agentic workflow, gh-aw, update workflow, debug workflow, upgrade workflow, compile workflow, safe outputs, workflow triggers, MCP server workflow, shared workflow component, label command, slash command, agentic automation, GitHub Actions AI agent. | None | | |
| | github-agentic-workflows | Create, update, debug, upgrade, and manage GitHub Agentic Workflows (gh-aw). Covers workflow creation with YAML frontmatter and markdown prompts, trigger configuration, safe-outputs, MCP server integration, shared components, security best practices, and compilation. WHEN: create agentic workflow, gh-aw, update workflow, debug workflow, upgrade workflow, compile workflow, safe outputs, workflow triggers, MCP server workflow, shared workflow component, label command, slash command, agentic automation, GitHub Actions AI agent. | None | |
| "agents": [ | ||
| "./agents/task-researcher.md", | ||
| "./agents/task-planner.md" | ||
| "./agents" |
There was a problem hiding this comment.
The agents manifest entry was changed from explicit agent files to the ./agents directory. If the plugin loader expects a list of concrete agent markdown files (as the prior version implied), this can break agent discovery at runtime. Consider keeping explicit agent file paths, or (if directory discovery is intended) ensure the repository’s plugin validation tooling covers directory entries and that this format is consistently supported.
Suggested change
| "./agents" | |
| "./agents/<agent-file-1>.agent.md", | |
| "./agents/<agent-file-2>.agent.md" |
Comment on lines
+2
to
+6
| "AD", | ||
| "AG", | ||
| "AI", | ||
| "AN", | ||
| "AQ", |
There was a problem hiding this comment.
This list includes country codes that are not current ISO 3166-1 alpha-2 assignments (e.g., AN, CS) and also includes XK (commonly used for Kosovo but not an official ISO 3166-1 code). If this file is used for validation/logic (rather than just display), these entries can cause incorrect acceptance/rejection. Recommend aligning to a clearly defined standard (ISO current list vs. include reserved/legacy codes) and documenting the rationale in the asset or the referencing docs.
Comment on lines
+21
to
+22
| "CK", | ||
| "CS", |
There was a problem hiding this comment.
This list includes country codes that are not current ISO 3166-1 alpha-2 assignments (e.g., AN, CS) and also includes XK (commonly used for Kosovo but not an official ISO 3166-1 code). If this file is used for validation/logic (rather than just display), these entries can cause incorrect acceptance/rejection. Recommend aligning to a clearly defined standard (ISO current list vs. include reserved/legacy codes) and documenting the rationale in the asset or the referencing docs.
Comment on lines
+104
to
+105
| "XK", | ||
| "YT" |
There was a problem hiding this comment.
This list includes country codes that are not current ISO 3166-1 alpha-2 assignments (e.g., AN, CS) and also includes XK (commonly used for Kosovo but not an official ISO 3166-1 code). If this file is used for validation/logic (rather than just display), these entries can cause incorrect acceptance/rejection. Recommend aligning to a clearly defined standard (ISO current list vs. include reserved/legacy codes) and documenting the rationale in the asset or the referencing docs.
| @@ -0,0 +1,5 @@ | |||
| 202.125.100.144/28,ID,,Jakarta, | |||
| 2605:59c8:2700::/40,CA,CA-QC,"Montreal" | |||
There was a problem hiding this comment.
The example CSV rows appear to have an inconsistent number of columns: other rows include a trailing comma for an empty last field, but this row does not. If consumers copy/paste this example into tooling that expects a fixed column count, it may parse differently than intended. Consider adding a trailing comma here for consistency with the other rows.
Suggested change
| 2605:59c8:2700::/40,CA,CA-QC,"Montreal" | |
| 2605:59c8:2700::/40,CA,CA-QC,"Montreal", |
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.
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.stagedbranch for this pull request.Description
This pull request adds documentation for a new skill related to GitHub Agentic Workflows in the
docs/README.skills.mdfile. The most important change is the introduction of this skill, which provides comprehensive management and automation capabilities for GitHub Agentic Workflows.New skill documentation:
github-agentic-workflowsskill, which enables creation, updating, debugging, upgrading, and management of GitHub Agentic Workflows (gh-aw). The documentation covers workflow creation with YAML frontmatter and markdown prompts, trigger configuration, safe-outputs, MCP server integration, shared components, security best practices, and workflow compilation. It also specifies when to use this skill for various agentic automation and workflow tasks. ([docs/README.skills.mdR152](https://github.com/github/awesome-copilot/pull/1318/files#diff-9025ebe01c6c8c7f68983c1c7c93f77933061de0c22957bbdd03f83bb0820b45R152))Type of Contribution