Skip to content

Latest commit

 

History

History
299 lines (225 loc) · 16 KB

File metadata and controls

299 lines (225 loc) · 16 KB

Agent Skills

This repository exposes the same skills through several discovery conventions so they work across coding tools without maintaining divergent copies.

For desktop installation, see the Claude plugin guide or ChatGPT/Codex on Mac. Both distribute the same seven repo-owned skills; the upstream gh-aw dispatcher stays repo-only.

How the skills fit together

The repo-owned skills follow one path: assess → design → build.

Skill Step Owns
agentic-workflow-planner Assess, Design Readiness and current-state assessment; pain-point-to-workflow mapping; living-document requirements; human gates; choosing the platform; the handoff contract a builder starts from
github-workflow-builder Build GitHub scaffolding: folders, blank docs, issue templates, labels, Projects, copied gh-aw workflows, gh aw compile
claude-native-workflow-builder Build Claude Routines and Scheduled Tasks: surface choice, triggers, governance, port fidelity
productboard-agent-builder Build Productboard Spark skills: adaptation, browser deployment, schedules
atlassian-agent-builder Build Rovo agents and Jira/Confluence automation
google-workspace-agent-builder Build Plan-aware Workspace Studio flows and skills
microsoft-365-agent-builder Build Plan-aware Microsoft 365 agents and automations
agentic-workflows gh-aw authoring Upstream dispatcher for gh-aw prompts

Keep platform-neutral guidance in the planner (references/assess.md, references/design.md). Builders should reference it rather than restate it, and should hold only platform-specific steps. A request that already names a platform and a workflow goes straight to that builder.

For a presenter walkthrough of every skill, see the skills demo script.

Renamed in plugin 0.4.0

Old name New location
org-work-sensing Assess mode of agentic-workflow-planner
non-coder-agentic-workflow-builder Design mode of agentic-workflow-planner (workflow selection) and github-workflow-builder (GitHub setup)

Layout

Path Purpose
.github/skills/ Canonical skill files and GitHub/Copilot discovery
.agents/skills/ Relative links for Codex and open Agent Skills-compatible tools
.claude/skills/ Relative links for Claude-style skill discovery
AGENTS.md Portable guidance and fallback pointers

Relative links are checked into Git. On Windows, enable Git symlink support before cloning if the links are checked out as plain text files.

Ownership

GitHub Next-owned skill

.github/skills/agentic-workflows/SKILL.md is an upstream dispatcher maintained in github/gh-aw. Keep it as an upstream snapshot and avoid repo-specific edits.

Refresh it with:

gh aw upgrade --no-fix
.github/scripts/sync-agent-skills.sh --check

gh aw upgrade --no-fix refreshes the upstream dispatcher and custom agent without applying workflow codemods, updating actions, or recompiling workflows. Review the resulting diff before committing.

After refreshing, update .github/skills/agentic-workflows/.upstream-version to the release used. The checked-in dispatcher and custom agent currently match gh-aw release v0.89.21, and the consumer Copilot setup installs v0.89.21.

The repository's installed CLI or generated workflow action versions can differ. Run gh aw upgrade separately when intentionally upgrading and recompiling the workflows themselves.

Repo-owned skills

Edit the canonical files under .github/skills/; the discovery links expose changes to other tools automatically.

.github/skills/agentic-workflow-planner/ is maintained in this repository. It is the platform-neutral front door: Assess mode (current-state assessment, readiness gaps, work-signal review) and Design mode (workflow selection, living documents, human gates, platform choice).

.github/skills/github-workflow-builder/ is maintained in this repository. It builds a planner design on GitHub. Its blank templates in assets/blank-repo/ are also the living-document templates the other builders point to.

.github/skills/claude-native-workflow-builder/ is maintained in this repository. Use it to port this repo's existing workflows (one, several, or a whole pipeline) — or build a new always-on automation — onto Claude Routines and Claude Scheduled Tasks instead of GitHub Agentic Workflows. It reads the current .github/workflows/*.md/.yml files directly rather than working from a separately maintained example, so the port stays current as those workflows change.

.github/skills/productboard-agent-builder/ is maintained in this repository. It adapts selected workflows into Productboard Spark instructions, preserving evidence and human decisions, and designs or configures verified schedules and triggers. It distinguishes native Spark execution from external agents connected to Productboard.

.github/skills/atlassian-agent-builder/ is maintained in this repository. It adapts selected workflows into Atlassian Rovo agents and Jira or Confluence automation flows, keeping writes in automation actions where possible and preserving evidence and human decisions. It distinguishes Rovo agents, automation flows, Forge apps, and external agents using the Atlassian Rovo MCP Server.

.github/skills/google-workspace-agent-builder/ is maintained in this repository. It adapts selected workflows into Google Workspace Studio flows and skills. Before drafting, it reasons about which Google surface fits: Workspace edition, add-ons, admin settings, and Studio run quota decide between a Studio flow, a skill alone, Apps Script, Gemini Enterprise, a hybrid with GitHub, or a handoff to the Claude-native builder. Dated availability data lives in its references/surfaces-and-plans.md.

Using the Productboard Agent Builder

Use productboard-agent-builder from a checkout of this repository or the updated Claude plugin. The builder creates the Productboard instructions; installing the builder does not install those generated skills in Productboard. Source-based adaptations need a checkout or access to the plugin's recorded public workflow sources.

Start with a draft:

Use productboard-agent-builder to adapt Assumption Surfacer into a Productboard
Spark skill named assumption-surfacer. Read the source workflow. Analyze a brief
supplied in chat and return grounded questions without changing product records.
Show the instructions; do not deploy yet.

Then, when ready to create it:

Create the prepared assumption-surfacer skill in my signed-in Productboard
workspace. Use Personal visibility and manual slash-command invocation. Check
for an existing match, avoid duplicates, and verify the persisted instructions
independently of browser-local drafts. Do not create a schedule.

Deployment defaults to browser automation, so it requires an available browser control tool and a signed-in Productboard session with the appropriate access. The MCP inspected during testing did not manage skills or schedules. The builder rechecks direct API/MCP support when there is new capability evidence or when asked, rather than repeating discovery on every request. Browser availability depends on the host running the skill; installation does not provide that tool.

Scheduling is a separate request. Specify the skill, cadence, timezone, input, output destination, and whether to activate it. The builder checks current controls and distinguishes skill invocation settings from automation activation. Native event/webhook triggering remains unverified; do not assume it works because timed execution does.

What has been tested

User-reported tests in one workspace on September 29, 2026 exercised browser creation, updating without duplicates, independent verification of saved content, manual invocation, native timed invocation, email receipt, and deletion of the test automation while preserving the skill. These are bounded observations, not guarantees for every workspace or permission level.

For a new adaptation, test a small fictional input and a case that should produce no findings. Verify meaning and grounding rather than a fixed finding count. If automation testing is needed, separate an authorized Manual run for invocation and delivery from a timed run for scheduling. Agree on cleanup before activating a temporary recurring test; deletion also removes its run history. A manual run does not prove a schedule works, and completed execution does not prove delivery.

Detailed findings and unresolved limitations live in the skill's dated field observations. Maintain those observations there rather than duplicating UI instructions here. The repository checks below validate packaging and skill structure, not live Productboard behavior.

Using the Atlassian Agent Builder

Use atlassian-agent-builder from a checkout of this repository or the Claude plugin (0.5.0 and later). The builder produces Rovo agent settings, Behavior instructions, and automation flow specifications; installing the builder does not create anything in Atlassian.

Start with a draft:

Use atlassian-agent-builder to adapt Intake Triage into a Rovo agent for Jira
project KEY. Read the source workflow. Run it when the triage label is added, keep
acceptance for a human, and show the agent and automation configuration. Do not
deploy yet.

Then, when ready and signed in to the site in the browser:

Create the prepared agent in Rovo Studio and the automation flow in project KEY.
Check for existing matches, save the flow disabled, and verify the saved
configuration from a fresh page load.

What has been tested

Nothing live yet. Draft behavior was checked with five CLI prompts on September 29, 2026. The deployment and trigger guidance is derived from Atlassian documentation checked September 29, 2026, which conflicts on whether agent write tools run inside automation flows. The builder therefore routes writes through automation actions that consume {{agentResponse}}. Record the first site test in the skill's field observations.

Using the Google Workspace Agent Builder

Use google-workspace-agent-builder from a checkout of this repository or the Claude plugin (0.5.1 and later). The builder produces a surface decision, Studio skill instructions, and a flow specification; installing the builder does not create anything in Google Workspace.

Tell it your Workspace edition and any add-ons if you know them. Without them it gives a conditional recommendation.

Use google-workspace-agent-builder to adapt Intake Triage for our team. We're on
Business Standard and feedback arrives by email to a shared inbox, about 15 a
day. Keep acceptance for a human and show the flow and skill. Do not deploy yet.

Then, when ready and signed in to Workspace Studio in the browser:

Create the prepared skill and flow in Workspace Studio. Check for existing
matches, save the flow turned off, and verify the saved configuration from a
fresh page load.

The builder never changes Admin console settings. It names the settings an admin must turn on, such as custom steps, integrations, or webhooks.

What has been tested

Nothing live yet. The surface, edition, and quota guidance is derived from Google documentation and announcements checked September 29, 2026, including the September 17 custom starters, custom steps, integrations, and webhooks release. Some per-edition quotas come from third-party summaries and are marked as such. Six CLI prompts checked routing and surface reasoning in plan mode: Business Starter per-email triage (quota exceeded, so it batched to a daily run), Business Plus weekly status Doc, GitHub records with Gmail delivery on Business Standard, a personal Gmail account, an unknown edition (conditional recommendation), and planner routing. The webhook-direction and personal-account guidance was tightened after those runs.

Full drafts were then reviewed by adapting the decision log workflow (Business Standard, transcripts in Drive) with the packaged plugin, three times. Each review tightened the builder:

  • First draft: it read the paused schedule as manual-only, let the model decide duplicates, had no fallback for an unparseable response, and named gh-aw settings in its dropped list. This led to the shared reading guide and to fixes in both the Google and Atlassian builders.
  • Second draft: the schedule, fallback, and access-failure handling were fixed. It still named gh-aw settings, and it invented a tracking Sheet for GitHub comments.
  • Third draft: it kept the GitHub half in GitHub, checked duplicates in the flow by file ID, and kept the source's one-PR-per-run limit as one digest Doc per run. It still checked for empty input before checking for read failures, and put "nothing found" and a bad response on the same branch. The self-check now covers both. Settings names in backticks recurred in every draft; check for them when reviewing output.

The fixes from the third review have not been rerun. Record the first domain test in the skill's field observations.

Using the Microsoft 365 agent builder

Use microsoft-365-agent-builder to adapt a selected workflow into Microsoft 365 Agent Builder, Copilot Studio, or Power Automate. It separates conversational agents from scheduled/event execution and checks licensing, connector access, connection identity, approval, and duplicate handling before proposing a build. Its plan matrix separates base Microsoft 365 subscriptions, Copilot assignments for maker and audience, Copilot Studio capacity, and Power Automate rights. Interactive included use is evaluated separately from unattended consumption.

Use microsoft-365-agent-builder to adapt our weekly status report. Records are
in Microsoft Lists and the team reads updates in Teams. Draft only; identify
which licenses and tenant settings we need before setup.

The builder returns paste-ready instructions and an automation specification, including failure paths and on/off state. Unknown tenant facts remain explicit prerequisites. Microsoft Learn sources are linked in the skill's references; deployment has not been field-tested. Creating the skill does not deploy agents.

Validation

Run:

.github/scripts/sync-agent-skills.sh --check

The check verifies the discovery links, validates each SKILL.md, and reports gh-aw version alignment.

Claude plugin distribution

Canonical skills remain here under .github/skills/. The directory plugin in plugins/agentics-beyond-code/ is generated from them and packaging inputs under packaging/claude/. The plugin ships seven skills: the upstream agentic-workflows dispatcher is excluded (EXCLUDED_SKILLS in .github/scripts/build-claude-plugin.py) because it only fetches instructions from github/gh-aw and overlaps with github-workflow-builder in Cowork. The builders use it when present and otherwise fetch the gh-aw instructions directly. Do not edit generated copies or discovery links separately. The root marketplace points to this generated package. After skill edits, run:

python3 .github/scripts/build-claude-plugin.py --sync
.github/scripts/sync-agent-skills.sh --check
python3 .github/scripts/build-claude-plugin.py --check
python3 -B .github/scripts/test-claude-plugin.py

See Claude Cowork plugin for source-access differences, versioning, release builds, and behavioral smoke tests.

ChatGPT and Codex distribution

The OpenAI package is generated from the same canonical skills. After editing skills, also run python3 -B .github/scripts/build-chatgpt-plugin.py --sync, then --check and .github/scripts/test-chatgpt-plugin.py. See ChatGPT plugin for package validation and distribution.