Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions .github/skills/gh-agent-task/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,13 +129,13 @@ Fix auth

## Integration with GitHub Agentic Workflows

The `gh agent-task` extension is used by the `create-agent-task` safe output feature in GitHub Agentic Workflows (gh-aw).
The `gh agent-task` extension is used by the `create-agent-session` safe output feature in GitHub Agentic Workflows (gh-aw).

### Safe Output Configuration

```yaml
safe-outputs:
create-agent-task:
create-agent-session:
base: main # Base branch for agent task PR
target-repo: "owner/target-repo" # Cross-repository task creation
```
Expand All @@ -151,7 +151,7 @@ permissions:
actions: read
engine: claude
safe-outputs:
create-agent-task:
create-agent-session:
base: main

# Code Task Delegator
Expand All @@ -163,7 +163,7 @@ When an issue is labeled with "code-task", analyze the requirements and create a

The safe output processor:
1. Reads agent output from the workflow execution
2. Extracts `create_agent_task` items from the structured output
2. Extracts `create_agent_session` items from the structured output
3. Writes task descriptions to temporary files
4. Executes `gh agent-task create --from-file <file> --base <branch>`
5. Captures the created task URL and number
Expand Down Expand Up @@ -239,7 +239,7 @@ When `safe-outputs.staged: true`, agent tasks are previewed without creation:
```yaml
safe-outputs:
staged: true
create-agent-task:
create-agent-session:
```

**Staged Output:**
Expand Down Expand Up @@ -268,7 +268,7 @@ on:
types: [labeled]
engine: claude
safe-outputs:
create-agent-task:
create-agent-session:

When issue is labeled with "needs-implementation", create an agent task with implementation instructions.
```
Expand All @@ -281,7 +281,7 @@ on:
- cron: "0 9 * * 1" # Monday 9AM
engine: copilot
safe-outputs:
create-agent-task:
create-agent-session:
base: develop

Analyze codebase for improvement opportunities and create agent tasks for top 3 improvements.
Expand All @@ -293,7 +293,7 @@ Analyze codebase for improvement opportunities and create agent tasks for top 3
on: workflow_dispatch
engine: claude
safe-outputs:
create-agent-task:
create-agent-session:
target-repo: "organization/backend-repo"
base: main

Expand Down Expand Up @@ -359,23 +359,23 @@ Create agent task in backend repository to implement the API changes described i

## Output Structure

When used via safe outputs, the create-agent-task job provides outputs:
When used via safe outputs, the create-agent-session job provides outputs:

```yaml
outputs:
task_number: "123"
task_url: "https://github.com/owner/repo/issues/123"
session_number: "123"
session_url: "https://github.com/owner/repo/issues/123"
```

**Usage in Dependent Jobs:**
```yaml
jobs:
follow_up:
needs: create_agent_task
needs: create_agent_session
steps:
- name: Notify team
run: |
echo "Agent task created: ${{ needs.create_agent_task.outputs.task_url }}"
echo "Agent session created: ${{ needs.create_agent_session.outputs.session_url }}"
```

## References
Expand Down
5 changes: 0 additions & 5 deletions docs/public/editor/autocomplete-data.json
Original file line number Diff line number Diff line change
Expand Up @@ -2143,11 +2143,6 @@
"desc": "Enable AI agents to create GitHub issues from workflow output.",
"leaf": true
},
"create-agent-task": {
"type": "object|null",
"desc": "Enable creation of GitHub Copilot coding agent tasks from workflow output.",
"leaf": true
},
"create-agent-session": {
"type": "object|null",
"desc": "Enable creation of GitHub Copilot coding agent sessions from workflow output.",
Expand Down
Loading