Skip to content

Commit 2cddd08

Browse files
srivilliamsaisrivilliamsai
committed
Add Workday Developer agent skills suite
1 parent 42b1b60 commit 2cddd08

25 files changed

Lines changed: 580 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,14 @@ Community examples, open to everyone. This is the section external contributions
121121
| [`peer-kudos-home-card`](examples/peer-kudos-home-card) | An Extend app with a Home page card, custom business object, and orchestration that lets employees celebrate peer contributions and notifies managers. | Extend App |
122122
| [`pto-policy-agent-skill`](examples/pto-policy-agent-skill) | A markdown skill that teaches an agent to answer employee questions about PTO, leave accrual, rollover, and sick leave policy with clear escalation rules. | Agent Skill |
123123
| [`stock-notifications`](examples/stock-notifications) | An Extend app that fetches Workday's current stock price from an external API and displays it on a home page card. | Extend App |
124+
| [`workday-ai-gateway-skill`](examples/workday-ai-gateway-skill) | A markdown skill that reviews an AI Gateway or AWS starter call and keeps secrets out of the page. | Agent Skill |
125+
| [`workday-apis-skill`](examples/workday-apis-skill) | A markdown skill that chooses and reviews a Workday Graph, WQL, REST, or SOAP call. | Agent Skill |
126+
| [`workday-developer-copilot-skill`](examples/workday-developer-copilot-skill) | A markdown skill that shapes a prompt for Workday Developer Copilot and lists what must not be pasted. | Agent Skill |
127+
| [`workday-extend-skill`](examples/workday-extend-skill) | A markdown skill that reviews an Extend app shell and data model: AMD routes, SMD auth, business objects, and security domains. | Agent Skill |
128+
| [`workday-home-cards-skill`](examples/workday-home-cards-skill) | A markdown skill that reviews a Workday Home card definition and its tenant setting. | Agent Skill |
129+
| [`workday-orchestrate-skill`](examples/workday-orchestrate-skill) | A markdown skill that reviews an Orchestrate flow for Maya file shape, expressions, and secrets. | Agent Skill |
130+
| [`workday-pmd-skill`](examples/workday-pmd-skill) | A markdown skill that reviews an Extend page for a security domain, endpoint failures, widget ids, labels, and secrets. | Agent Skill |
131+
| [`workday-skill`](examples/workday-skill) | A markdown skill that chooses which Workday agent skill to apply when a task starts a new app or touches more than one artifact. | Agent Skill |
124132
| [`wql-anniversary-celebrations`](examples/wql-anniversary-celebrations) | An orchestration that queries Workday via WQL for active workers celebrating milestone work anniversaries and formats an announcement digest payload for collaboration channels. | Orchestration |
125133
<!-- examples:end -->
126134

‎examples/workday-ai-gateway-skill/README.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Workday AI Gateway Skill
2+
3+
## What it is
4+
5+
A markdown skill that reviews an AI Gateway call or an AWS starter flow from the Workday catalog. It covers document intelligence, WQL generation, sentiment analysis, and the AWS starter apps.
6+
7+
## What's inside
8+
9+
- `SKILL.md` is the skill: Gateway and AWS call rules, plus the catalog apps to copy.
10+
11+
## How to use it
12+
13+
1. Read `SKILL.md`.
14+
2. Add that file to your agent using your platform's skill setup.
15+
3. Ask the test questions at the bottom of `SKILL.md` and confirm the agent names the rule it is using.
16+
17+
18+
## Before you deploy
19+
20+
This folder is markdown only. There is no app reference id, tenant host, secret, or worker id to replace. Do not add those values when you adapt the skill.
21+

‎examples/workday-ai-gateway-skill/SKILL.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
name: workday-ai-gateway
3+
description: Reviews Workday AI Gateway calls and the AWS starter pattern in the Workday catalog. Use when editing document intelligence, WQL generation, sentiment analysis, or AWS Translate, Textract, Comprehend, or badge flows. Do not use for ordinary .pmd layout or for prompts to Workday Developer Copilot.
4+
---
5+
6+
# Workday AI Gateway
7+
8+
Review the Gateway or AWS call. Report only genuine problems. The page still follows `workday-pmd`. The flow still follows `workday-orchestrate`.
9+
10+
| Need | Open first |
11+
| --- | --- |
12+
| Natural language to WQL | `catalog/generateWQL` |
13+
| Document intelligence | `catalog/documentIntelligenceWithTheAIGateway` |
14+
| AWS Translate, Textract, and Comprehend | `catalog/AWSStarterKit` |
15+
| Badge photo and EventBridge | `catalog/AWSBadgeGenerator` |
16+
| Sentiment on stored text | `catalog/charitableDonationsWithSentimentAnalysis` |
17+
18+
## Rules
19+
20+
- Call the Gateway from an orchestration or an Extend endpoint inside the Workday boundary. Do not send worker documents from the browser to a public model.
21+
- Follow the call shape in the catalog sample you opened. Do not invent a Gateway path.
22+
- Treat model output as untrusted until the page or flow validates required fields.
23+
- Call AWS from the orchestration, not from the page. Store credentials in the tenant secret store.
24+
- Never write a secret, tenant host, access key, or webhook into a page, an AMD, or this skill.
25+
26+
## Output format
27+
28+
For each issue, state the file and line, name the rule, and show a short before and after. Skip clean files.
29+
30+
## Test questions
31+
32+
- "Where should the AWS secret key be stored?"
33+
- "Can the page call Textract directly?"
34+
- "The model omitted a required field. What should the flow do?"

‎examples/workday-ai-gateway-skill/example.json‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"title": "Workday AI Gateway Skill",
3+
"description": "A markdown skill that reviews an AI Gateway or AWS starter call and keeps secrets out of the page.",
4+
"type": "Agent Skill",
5+
"components": [
6+
"AWS Integration"
7+
],
8+
"products": [
9+
"Workday Extend"
10+
],
11+
"authors": [
12+
"srivilliamsai"
13+
],
14+
"tutorial": "",
15+
"source": "community"
16+
}

‎examples/workday-apis-skill/README.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Workday APIs Skill
2+
3+
## What it is
4+
5+
A markdown skill that picks Graph, WQL, REST, or SOAP and then reviews the call. It points at catalog samples for each protocol.
6+
7+
## What's inside
8+
9+
- `SKILL.md` is the skill: how to choose an API, and the rules for each call style.
10+
11+
## How to use it
12+
13+
1. Read `SKILL.md`.
14+
2. Add that file to your agent using your platform's skill setup.
15+
3. Ask the test questions at the bottom of `SKILL.md` and confirm the agent names the rule it is using.
16+
17+
18+
## Before you deploy
19+
20+
This folder is markdown only. There is no app reference id, tenant host, secret, or worker id to replace. Do not add those values when you adapt the skill.
21+

‎examples/workday-apis-skill/SKILL.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
name: workday-apis
3+
description: Chooses and reviews Workday REST, SOAP, Graph API, and WQL calls. Use when editing .graphquery or .wqlquery files, or when writing REST, SOAP, OAuth, or pagination handling. Do not use for .pmd layout or .orchestration step structure.
4+
---
5+
6+
# Workday APIs
7+
8+
Pick the API, then review the call. Report only genuine problems.
9+
10+
| Need | API | Open first |
11+
| --- | --- | --- |
12+
| A few fields in one round trip | Graph | `catalog/vehicleRegistration/presentation/graphQueries` |
13+
| Create or update one resource | REST | `catalog/updateWorkdayAccounts` |
14+
| Bulk XML | SOAP | `catalog/workerInboundImageUpload` |
15+
| A report or extract | WQL | `catalog/employeeRecognition/presentation/wqlQueries` and `catalog/wql` |
16+
| One Graph call that creates a record | Graph | `catalog/createSpotBonus` |
17+
18+
## Rules
19+
20+
- Store a Graph query as `.graphquery` JSON with `id` and `query`. The page sets `graphQuery.queryId` to that id, `baseUrlType` `workday-graph`, and `httpMethod` `POST`.
21+
- Store a WQL query in `presentation/wqlQueries/<id>.wqlquery` with `id`, `parameters`, and `query`. Every `<% name %>` token is listed in `parameters`.
22+
- Get a REST token with the client-credentials grant. Never write the client id, client secret, or access token into a source file.
23+
- Page REST results with `limit` (maximum 100) and `offset`. On 429, back off. On 401, refresh the token.
24+
- Address SOAP by the tenant service host name. Do not pin an IP. Keep the envelope in an orchestration, not in a page.
25+
- Never log a token or a body that contains pay or a government identifier.
26+
27+
## Output format
28+
29+
For each issue, state the file and line, name the rule, and show a short before and after. Skip clean files.
30+
31+
## Test questions
32+
33+
- "The page needs five worker fields. Which API do I use?"
34+
- "Where does the Graph query text live?"
35+
- "The REST call returns 429. What should the client do?"

‎examples/workday-apis-skill/example.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{
2+
"title": "Workday APIs Skill",
3+
"description": "A markdown skill that chooses and reviews a Workday Graph, WQL, REST, or SOAP call.",
4+
"type": "Agent Skill",
5+
"components": [
6+
"Graph API",
7+
"WQL"
8+
],
9+
"products": [
10+
"Workday REST API",
11+
"Workday SOAP API"
12+
],
13+
"authors": [
14+
"srivilliamsai"
15+
],
16+
"tutorial": "",
17+
"source": "community"
18+
}

‎examples/workday-developer-copilot-skill/README.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Workday Developer Copilot Skill
2+
3+
## What it is
4+
5+
A markdown skill that writes a prompt for the product Workday Developer Copilot. It names the artifact to generate and the data that must stay out of the prompt.
6+
7+
## What's inside
8+
9+
- `SKILL.md` is the skill: prompt contents and the privacy limits.
10+
11+
## How to use it
12+
13+
1. Read `SKILL.md`.
14+
2. Add that file to your agent using your platform's skill setup.
15+
3. Ask the test questions at the bottom of `SKILL.md` and confirm the agent names the rule it is using.
16+
17+
18+
## Before you deploy
19+
20+
This folder is markdown only. There is no app reference id, tenant host, secret, or worker id to replace. Do not add those values when you adapt the skill.
21+

‎examples/workday-developer-copilot-skill/SKILL.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
name: workday-developer-copilot
3+
description: Shapes prompts for the product Workday Developer Copilot. Use when the user names Workday Developer Copilot and wants a prompt for an Extend model, a PMD page, an orchestration, or an API payload. Do not use for reviewing application source.
4+
---
5+
6+
# Workday Developer Copilot
7+
8+
Write one prompt the user can paste. Then list what you left out. Do not invent tenant data to fill the prompt.
9+
10+
After Copilot returns JSON, check a page with `workday-pmd`, a model with `workday-extend`, and a flow with `workday-orchestrate`. A generated page that uses `rootWidget` does not match catalog `.pmd` files. Rebuild it as `id`, `securityDomains`, `endPoints`, and `presentation`.
11+
12+
## The prompt names
13+
14+
- The artifact: business object, PMD page, orchestration, or API payload.
15+
- Widget ids and field labels when the target is a page.
16+
- The data source or route name when the target is a page or a flow.
17+
- The HTTP method, path, and scope when the target is an API call.
18+
- Multi-line JSON with 2-space indentation.
19+
20+
## Do not paste
21+
22+
- A client secret, access token, refresh token, certificate, or webhook URL.
23+
- Production worker rows, pay, bank data, government ids, or documents.
24+
- A tenant hostname. Say "sandbox tenant" instead.
25+
26+
## Test questions
27+
28+
- "Write a Workday Developer Copilot prompt for a PMD page that registers a vehicle."
29+
- "Can I paste this access token so Copilot can test the call?"
30+
- "Copilot returned a page with rootWidget. What should I do next?"

‎examples/workday-developer-copilot-skill/example.json‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"title": "Workday Developer Copilot Skill",
3+
"description": "A markdown skill that shapes a prompt for Workday Developer Copilot and lists what must not be pasted.",
4+
"type": "Agent Skill",
5+
"components": [],
6+
"products": [
7+
"Workday Extend"
8+
],
9+
"authors": [
10+
"srivilliamsai"
11+
],
12+
"tutorial": "",
13+
"source": "community"
14+
}

0 commit comments

Comments
 (0)