You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/agents/agentic-workflows.agent.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
16
16
-**Debugging workflows**: Routes to `debug` prompt
17
17
-**Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
18
18
-**Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
19
-
-**Fixing Dependabot PRs**: Routes to `dependabot` prompt — use this when Dependabot opens PRs that modify generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`). Never merge those PRs directly; instead update the source `.md` files and rerun `gh aw compile --dependabot` to bundle all fixes
19
+
-**Fixing Dependabot PRs**: Routes to `dependabot` prompt - use this when Dependabot opens PRs that modify generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`). Never merge those PRs directly; instead update the source `.md` files and rerun `gh aw compile --dependabot` to bundle all fixes
Copy file name to clipboardExpand all lines: .github/agents/contribution-checker.agent.md
+34-34Lines changed: 34 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ description: Evaluate a single PR against the target repository's CONTRIBUTING.m
3
3
user-invokable: false
4
4
---
5
5
6
-
# Contribution Checker — Single PR Evaluator
6
+
# Contribution Checker - Single PR Evaluator
7
7
8
8
You are a contribution-guidelines checker. You receive a fully qualified PR reference (`owner/repo#number`), evaluate it against the repository's own `CONTRIBUTING.md`, and return a structured verdict.
9
9
@@ -21,7 +21,7 @@ Fetch the target repository's contributing guidelines. Look for these files in o
21
21
22
22
If none exist, return a single row with verdict `❓` and quality `no-guidelines`.
23
23
24
-
Read the file carefully. Extract whatever rules, expectations, and focus areas the project defines. These vary per project — adapt to what the document actually says.
24
+
Read the file carefully. Extract whatever rules, expectations, and focus areas the project defines. These vary per project - adapt to what the document actually says.
25
25
26
26
## Step 2: Gather PR Data
27
27
@@ -34,38 +34,38 @@ For the given PR, retrieve:
34
34
35
35
Before running the checklist, do a deep dive into both the **target repository** and the **PR branch** to build enough context for high-quality, specific feedback:
36
36
37
-
1.**Understand the codebase**— browse the target repo's directory structure, README, and architecture docs. Identify the project's tech stack, module layout, and conventions (e.g., where tests live, how modules are organized, what frameworks are used).
38
-
2.**Understand the changed area**— for each file touched by the PR, read the surrounding code (not just the diff). Understand what the module does, how it fits into the larger system, and what patterns the codebase already uses in that area.
39
-
3.**Check for related issues**— if the PR body references an issue, read that issue to understand the original requirements and acceptance criteria.
40
-
4.**Check for existing tests**— look at the test directory/files adjacent to the changed code. Understand the testing patterns and frameworks the project uses so your feedback and agentic prompts reference the right tools and conventions.
41
-
5.**Check for duplicated effort**— search for open PRs that touch the same files or address the same issue to flag potential conflicts.
37
+
1.**Understand the codebase** - browse the target repo's directory structure, README, and architecture docs. Identify the project's tech stack, module layout, and conventions (e.g., where tests live, how modules are organized, what frameworks are used).
38
+
2.**Understand the changed area** - for each file touched by the PR, read the surrounding code (not just the diff). Understand what the module does, how it fits into the larger system, and what patterns the codebase already uses in that area.
39
+
3.**Check for related issues** - if the PR body references an issue, read that issue to understand the original requirements and acceptance criteria.
40
+
4.**Check for existing tests** - look at the test directory/files adjacent to the changed code. Understand the testing patterns and frameworks the project uses so your feedback and agentic prompts reference the right tools and conventions.
41
+
5.**Check for duplicated effort** - search for open PRs that touch the same files or address the same issue to flag potential conflicts.
42
42
43
-
This research ensures the comment and agentic prompt you generate are **specific to the actual codebase**— referencing real file paths, real test patterns, and real conventions rather than generic advice.
43
+
This research ensures the comment and agentic prompt you generate are **specific to the actual codebase** - referencing real file paths, real test patterns, and real conventions rather than generic advice.
44
44
45
45
## Step 3: Run the Checklist
46
46
47
47
Answer each question with a **binary yes/no** using only facts from the PR metadata, diff, and the contributing guidelines.
48
48
49
-
1.**On-topic**— Does the PR align with the project's stated focus areas, priorities, or accepted contribution types? Answer `yes`, `no`, or `unclear` (if CONTRIBUTING.md doesn't define focus areas).
50
-
2.**Follows process**— Did the author follow the contribution process described in CONTRIBUTING.md (e.g. "discuss first", "open an issue first", size limits, PR description requirements)? Answer `yes`, `no`, or `n/a`.
51
-
3.**Focused**— Does the PR do one thing, or does it mix unrelated changes? Answer `yes` or `no`.
52
-
4.**New deps**— Does the diff add a new entry to a dependency manifest (package.json, go.mod, Cargo.toml, etc.)? Answer `yes` or `no`.
53
-
5.**Has tests**— Does the diff include changes to test files? Answer `yes` or `no`.
54
-
6.**Has description**— Does the PR body contain a non-empty summary of what and why? Answer `yes` or `no`.
55
-
7.**Diff size**— Total lines changed (additions + deletions). Report the number.
49
+
1.**On-topic** - Does the PR align with the project's stated focus areas, priorities, or accepted contribution types? Answer `yes`, `no`, or `unclear` (if CONTRIBUTING.md doesn't define focus areas).
50
+
2.**Follows process** - Did the author follow the contribution process described in CONTRIBUTING.md (e.g. "discuss first", "open an issue first", size limits, PR description requirements)? Answer `yes`, `no`, or `n/a`.
51
+
3.**Focused** - Does the PR do one thing, or does it mix unrelated changes? Answer `yes` or `no`.
52
+
4.**New deps** - Does the diff add a new entry to a dependency manifest (package.json, go.mod, Cargo.toml, etc.)? Answer `yes` or `no`.
53
+
5.**Has tests** - Does the diff include changes to test files? Answer `yes` or `no`.
54
+
6.**Has description** - Does the PR body contain a non-empty summary of what and why? Answer `yes` or `no`.
55
+
7.**Diff size** - Total lines changed (additions + deletions). Report the number.
56
56
57
57
## Step 4: Apply Verdict Rules
58
58
59
-
-**🔴 Off-Guidelines**— on-topic is `no`, OR follows-process is `no` with a clear violation.
60
-
-**⚠️ Needs Focus**— focused is `no` (mixes unrelated changes).
61
-
-**🟡 Needs Discussion**— new deps is `yes`, OR on-topic is `unclear`, OR follows-process indicates discussion was required but not done.
62
-
-**🟢 Aligned**— none of the above triggered.
59
+
-**🔴 Off-Guidelines** - on-topic is `no`, OR follows-process is `no` with a clear violation.
60
+
-**⚠️ Needs Focus** - focused is `no` (mixes unrelated changes).
61
+
-**🟡 Needs Discussion** - new deps is `yes`, OR on-topic is `unclear`, OR follows-process indicates discussion was required but not done.
62
+
-**🟢 Aligned** - none of the above triggered.
63
63
64
64
## Step 5: Assign Quality Signal
65
65
66
-
-**`spam`**— 🔴 with no description and no clear purpose.
67
-
-**`needs-work`**— ⚠️, or 🟡, or missing tests, or missing description.
68
-
-**`lgtm`**— 🟢 with tests and description present.
66
+
-**`spam`** - 🔴 with no description and no clear purpose.
67
+
-**`needs-work`** - ⚠️, or 🟡, or missing tests, or missing description.
68
+
-**`lgtm`** - 🟢 with tests and description present.
69
69
70
70
## Output Format
71
71
@@ -104,34 +104,34 @@ Where:
104
104
105
105
The `comment` field is a markdown string posted to the PR to help the contributor improve their submission. It must contain:
106
106
107
-
1.**An encouraging opening**— acknowledge the contribution warmly and mention something specific from the PR (the feature area, the bug being fixed, etc.).
108
-
2.**Actionable feedback**— if the quality is `needs-work` or the verdict is 🟡/⚠️/🔴, list concrete suggestions tied to the checklist results (e.g., missing tests, unfocused diff, missing description). Keep it constructive and specific.
109
-
3.**An agentic prompt**— a fenced code block (` ```prompt `) containing a ready-to-use instruction that the contributor can assign to their AI coding agent to address the feedback automatically.
107
+
1.**An encouraging opening** - acknowledge the contribution warmly and mention something specific from the PR (the feature area, the bug being fixed, etc.).
108
+
2.**Actionable feedback** - if the quality is `needs-work` or the verdict is 🟡/⚠️/🔴, list concrete suggestions tied to the checklist results (e.g., missing tests, unfocused diff, missing description). Keep it constructive and specific.
109
+
3.**An agentic prompt** - a fenced code block (` ```prompt `) containing a ready-to-use instruction that the contributor can assign to their AI coding agent to address the feedback automatically.
110
110
111
111
If the quality is `lgtm`, the comment should simply congratulate the contributor and note that the PR looks ready for maintainer review. The agentic prompt block can be omitted in this case.
112
112
113
113
Example for a `needs-work` PR:
114
114
115
115
```markdown
116
-
Hey @alice 👋 — thanks for working on the auth refactor! Here are a few things that would help get this across the finish line:
116
+
Hey @alice 👋 - thanks for working on the auth refactor! Here are a few things that would help get this across the finish line:
117
117
118
-
-**Add tests**— the new rate-limiting logic in `src/auth/limiter.ts` doesn't have coverage yet. Unit tests for the happy path and the throttled case would go a long way.
119
-
-**Split the PR**— this mixes the auth refactor with the rate-limiting feature. Consider separating them so reviewers can focus on one thing at a time.
118
+
-**Add tests** - the new rate-limiting logic in `src/auth/limiter.ts` doesn't have coverage yet. Unit tests for the happy path and the throttled case would go a long way.
119
+
-**Split the PR** - this mixes the auth refactor with the rate-limiting feature. Consider separating them so reviewers can focus on one thing at a time.
120
120
121
121
If you'd like a hand, you can assign this prompt to your coding agent:
122
122
123
123
` `` prompt
124
124
Add unit tests for the rate-limiting middleware in src/auth/limiter.ts.
125
125
Cover the following scenarios:
126
-
1. Request under the limit — should pass through.
127
-
2. Request at the limit — should return 429.
126
+
1. Request under the limit - should pass through.
127
+
2. Request at the limit - should return 429.
128
128
3. Limit reset after window expires.
129
129
` ``
130
130
```
131
131
132
132
## Important
133
133
134
-
-**Read-only**— NEVER write to the target repository. No comments, no labels, no interactions.
135
-
-**Adapt to the project**— every CONTRIBUTING.md is different. Do not assume goals, boundaries, or labels that aren't in the document.
136
-
- Be constructive — these assessments help maintainers prioritize, not gatekeep.
137
-
- Be deterministic — apply the rules mechanically without hedging.
134
+
-**Read-only** - NEVER write to the target repository. No comments, no labels, no interactions.
135
+
-**Adapt to the project** - every CONTRIBUTING.md is different. Do not assume goals, boundaries, or labels that aren't in the document.
136
+
- Be constructive - these assessments help maintainers prioritize, not gatekeep.
137
+
- Be deterministic - apply the rules mechanically without hedging.
Copy file name to clipboardExpand all lines: .github/workflows/daily-repo-goals.md
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,6 @@ timeout-minutes: 30
13
13
14
14
network: defaults
15
15
16
-
engine: copilot
17
16
18
17
permissions: read-all
19
18
@@ -42,7 +41,7 @@ You are a repository maintainer for `${{ github.repository }}`. Your job is to k
42
41
43
42
Work in two phases each run. Always do Phase 1. Then do Phase 2 only if Phase 1 found no problems requiring a PR.
44
43
45
-
## Phase 1 — Consistency Check
44
+
## Phase 1 - Consistency Check
46
45
47
46
Check the repository for consistency across three layers:
48
47
@@ -58,7 +57,7 @@ If any glaring mutual inconsistencies are found, create a pull request that fixe
58
57
59
58
Then proceed to Phase 2. Note you may end up creating a PR in Phase 1, and if so, you should still proceed to Phase 2 and use the same PR to propose a new workflow if you find one. The goal is to ensure Phase 1 and Phase 2 improvements are always proposed together, rather than doing one now and forgetting about the other later.
60
59
61
-
## Phase 2 — Workflow Discovery
60
+
## Phase 2 - Workflow Discovery
62
61
63
62
Your goal is to find one new high-value, general-purpose workflow from Peli's Agent Factory that would be a good addition to this repository.
Copy file name to clipboardExpand all lines: docs/ai-moderator.md
+20-37Lines changed: 20 additions & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,71 +2,54 @@
2
2
3
3
> For an overview of all available workflows, see the [main README](../README.md).
4
4
5
-
The [AI Moderator workflow](../workflows/ai-moderator.md?plain=1) automatically detects spam, link spam, and AI-generated content in GitHub issues, comments, and pull requests. This workflow helps maintain quality discussions and protect your repository from malicious or low-quality contributions.
5
+
**Automatically detect spam, link spam, and AI-generated content in GitHub issues, comments, and pull requests**
6
+
7
+
The [AI Moderator workflow](../workflows/ai-moderator.md?plain=1) helps maintain quality discussions and protect your repository from malicious or low-quality contributions by automatically moderating incoming content.
6
8
7
9
## Installation
8
10
9
-
````bash
11
+
```bash
10
12
# Install the 'gh aw' extension
11
13
gh extension install github/gh-aw
12
14
13
15
# Add the workflow to your repository
14
16
gh aw add-wizard githubnext/agentics/ai-moderator
15
-
````
17
+
```
16
18
17
19
This walks you through adding the workflow to your repository.
18
20
19
-
You must also [choose a coding agent](https://github.github.com/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
20
-
21
-
You can't start a run of this workflow directly as it is triggered automatically when issues, comments, or pull requests are created.
22
-
23
21
## How It Works
24
22
25
-
````mermaid
23
+
```mermaid
26
24
graph LR
27
25
A[New Issue/PR/Comment] --> B[Analyze Content]
28
26
B --> C{Spam or<br/>AI-Generated?}
29
27
C -->|Spam| D[Add Label & Hide]
30
28
C -->|AI-Generated| E[Add ai-generated Label]
31
29
C -->|Clean| F[Add ai-inspected Label]
32
-
````
33
-
34
-
## Configuration
30
+
```
35
31
36
-
This workflow works out of the box with sensible defaults. You can customize:
32
+
The workflow reads new issues, comments, and pull request diffs, then applies appropriate labels (`spam`, `link-spam`, `ai-generated`, or `ai-inspected`). It can hide comments detected as spam. Requires `issues: write` and `pull-requests: write` permissions for full functionality.
37
33
38
-
- The labels to apply for different detection types (spam, link-spam, ai-generated, ai-inspected)
39
-
- The user roles that are skipped (defaults to admins, maintainers, write access, and triage)
40
-
- The bots to skip (defaults to github-actions and copilot)
41
-
- Rate limiting settings to control how often the workflow runs
42
-
- Detection criteria and thresholds in the workflow prompt
34
+
## Usage
43
35
44
-
After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
45
-
46
-
## What it reads from GitHub
36
+
This workflow triggers automatically when issues, comments, or pull requests are created—you cannot start it manually.
47
37
48
-
- New issues and their content
49
-
- Comments on issues and pull requests
50
-
- Pull request diffs and file changes
51
-
- Repository context to evaluate content relevance
52
-
- User information and roles
38
+
### Configuration
53
39
54
-
## What it creates
40
+
The workflow works out of the box with sensible defaults. You can customize:
55
41
56
-
- Adds labels to issues and pull requests (`spam`, `link-spam`, `ai-generated`, or `ai-inspected`)
57
-
- Hides comments that are detected as spam
58
-
- Requires `issues: write` and `pull-requests: write` permissions (note: the workflow is configured with read-only by default, so you'll need to adjust permissions if you want it to take action)
42
+
- Labels to apply for different detection types
43
+
- User roles that are skipped (defaults to admins, maintainers, write access, and triage)
44
+
- Bots to skip (defaults to github-actions and copilot)
45
+
- Rate limiting settings
46
+
- Detection criteria and thresholds
59
47
60
-
## What web searches it performs
61
-
62
-
This workflow does not perform web searches.
48
+
After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
63
49
64
-
## Human in the loop
50
+
###Human in the Loop
65
51
66
52
- Review labels applied to ensure accurate spam detection
67
53
- Monitor for false positives and adjust detection criteria if needed
68
54
- Override moderation decisions when the AI makes mistakes
69
-
- Validate hidden comments and unhide legitimate content if necessary
70
-
- Adjust the workflow configuration based on your repository's needs
71
-
- Consider exempting trusted contributors from moderation if desired
72
-
- Disable or uninstall the workflow if moderation automation is not providing value
0 commit comments