Skip to content
Merged
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
10 changes: 10 additions & 0 deletions .agents/skills/check-pr-ci/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
name: check-pr-ci
description: Check the latest test-related CI results for the current pull request.
allowed-tools: Bash(bun:*), Bash(gh:*), Bash(git:*)
---

# Check PR CI

Run the following command with 1 hour timeout to inspect the latest CI status: `bunx @willbooster/agent-skills@latest check-pr-ci`
It classifies the latest result of each workflow as `successful`, `running`, or `failed`.
29 changes: 29 additions & 0 deletions .agents/skills/complete-pr/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
name: complete-pr
description: Complete GitHub pull requests by iterating on CI and review feedback until the PR is ready.
---

First, fetch the current repository owner with `gh repo view --json owner --jq '.owner.login'`.
If the owner is `WillBooster` or `WillBoosterLab`, follow the first workflow below.
Otherwise, follow the second workflow below.

## Workflow for `WillBooster` or `WillBoosterLab` repositories

1. Read the PR body and its messages with the `fetch-pr` skill.
2. Check the results of CI (GitHub Actions) with the `check-pr-ci` skill.
3. If any workflow has failed, fix the CI issues, commit, push, and then return to step 2. Otherwise, go to step 4.
4. Fetch unresolved review threads with the `manage-pr-review-threads` skill.
5. Review each unresolved thread and decide whether it requires a code or documentation change. Validate each claim against the current codebase first, and reproduce it or check official documentation when needed instead of relying on memory. Ignore only comments that are clearly outdated, incorrect, or intentionally declined with solid reasoning.
6. If there are valid review comments to address, make only the changes supported by the validation from step 5, commit, push, and post `/gemini review` to the PR.
7. Reply to all review threads with the `manage-pr-review-threads` skill.
8. If you made any changes in step 6, wait for 5 minutes (`sleep 5m`) then return to step 2. Otherwise, stop.

## Workflow for the other repositories

1. Read the PR body and its messages with the `fetch-pr` skill.
2. Check the results of CI (GitHub Actions) with the `check-pr-ci` skill.
3. If any workflow has failed, fix the CI issues, commit, push, and then return to step 2. Otherwise, go to step 4.
4. Fetch unresolved review threads.
5. Review each unresolved thread and decide whether it requires a code or documentation change. Validate each claim against the current codebase first, and reproduce it or check official documentation when needed instead of relying on memory. Ignore only comments that are clearly outdated, incorrect, or intentionally declined with solid reasoning.
6. If there are valid review comments to address, make only the changes supported by the validation from step 5, commit, push, and then return to step 2. Otherwise, stop.
- Do not post any message like review replies on non-WillBooster repositories.
9 changes: 9 additions & 0 deletions .agents/skills/fetch-issue/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
name: fetch-issue
description: Fetch a GitHub issue body and its messages for the current repository or an issue URL.
allowed-tools: Bash(bun:*), Bash(gh:*)
---

# Fetch GitHub Issue Messages

Run the following command to fetch the issue body and its messages: `bunx @willbooster/agent-skills@latest fetch-issue <issue-number-or-url>`
9 changes: 9 additions & 0 deletions .agents/skills/fetch-pr/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
name: fetch-pr
description: Fetch a GitHub pull request body and its messages for the current repository or a pull request URL.
allowed-tools: Bash(bun:*), Bash(gh:*)
---

# Fetch GitHub PR Messages

Run the following command to fetch the pull request body and messages, excluding inline review comments: `bunx @willbooster/agent-skills@latest fetch-pr <pr-number-or-url>`
21 changes: 21 additions & 0 deletions .agents/skills/fix-bug/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
name: fix-bug
description: Fix a reported bug by first enhancing tests until the bug is reproduced, then fixing the implementation, and finally confirming the enhanced tests pass.
---

# Bug fix workflow

1. Understand the reported bug precisely.
- Identify the expected behavior, the actual behavior, and the smallest scope that reproduces the problem.
2. Inspect the existing tests and locate the best place to extend them.
- Prefer enhancing an existing focused test file over adding a broad new one.
3. Before modifying tests, gather debugging evidence that helps explain the failure mode.
- Use logging, screenshots, traces, or other lightweight diagnostics that fit the stack.
4. Enhance the tests until they reproduce the bug.
- If a relevant test already fails for the bug, keep it as the reproduction and tighten it only if needed.
- Stop once the reproduction is minimal, reliable, and clearly tied to the reported bug.
5. Fix the implementation without weakening the new or existing assertions.
- Keep the code change as small and cohesive as possible.
6. Run the enhanced tests and confirm they pass with the fix in place.
7. If the repository workflow requires broader verification, run the relevant checks after the targeted tests pass.
8. Summarize the root cause, the test enhancement, and the implementation fix.
35 changes: 35 additions & 0 deletions .agents/skills/manage-pr-review-threads/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
name: manage-pr-review-threads
description: Inspect unresolved review threads for the current pull request, then reply to and resolve them as needed.
allowed-tools: Bash(bun:*), Bash(gh:*), Bash(git:*)
---

# Manage PR Review Threads

Use this skill when you need to inspect unresolved review threads and then reply to or resolve them.

## List unresolved review threads

```bash
bunx @willbooster/agent-skills@latest list-pr-review-threads
```

## Reply to and resolve review threads

```bash
bunx @willbooster/agent-skills@latest resolve-pr-review-threads <<'EOF'
{
"replies": {
"PRRT_kwDORiWJ-851nXBt": "Fixed in the latest update.",
"PRRT_kwDORiWJ-851nXBu": "Kept as-is intentionally. Added clarification in the code."
}
}
EOF
```

The JSON object must contain `replies`, keyed by review thread ID.

## Notes

- Run the commands from the repository that owns the pull request you want to inspect.
- `resolve-pr-review-threads` depends on thread IDs returned by `list-pr-review-threads`.
39 changes: 39 additions & 0 deletions .agents/skills/open-pr/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
name: open-pr
description: Create a pull request for the current branch in the current repository.
allowed-tools: Bash(bun:*), Bash(gh:*), Bash(git:*)
---

# Open PR workflow

Commit your changes and push them to the current branch.
Write a PR body that helps reviewers quickly understand the scope, motivation, and validation.
Include the linked issue when applicable, a concise summary of the changes, the reasoning behind them, and how they were tested.
Run the following command to open a pull request.
Finally, report the PR URL.

```bash
bunx @willbooster/agent-skills@latest open-pr <<'EOF'
Close #<issue>

## Summary

- What changed
- Key scope or affected area
- Any notable tradeoff or limitation

## Why

- Problem being solved
- Reason this approach was chosen

## Testing

- Exact commands run
- Manual verification steps if relevant

## Notes (if needed)

- Breaking changes, rollout concerns, screenshots, or follow-up work
EOF
```
10 changes: 10 additions & 0 deletions .agents/skills/plan-issue-claude/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
name: plan-issue-claude
description: Run Claude Code planning via the CLI and report the planning results.
allowed-tools: Bash(bunx:*)
---

# Planning workflow

1. Run the following command from the repository root with 1 hour timeout: `bunx @willbooster/agent-skills@latest plan --agent claude`
2. Report on the issue URL.
10 changes: 10 additions & 0 deletions .agents/skills/plan-issue-codex/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
name: plan-issue-codex
description: Run Codex planning via the CLI and report the planning results.
allowed-tools: Bash(bunx:*)
---

# Planning workflow

1. Run the following command from the repository root with 1 hour timeout: `bunx @willbooster/agent-skills@latest plan --agent codex`
2. Report on the issue URL.
10 changes: 10 additions & 0 deletions .agents/skills/plan-issue-gemini/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
name: plan-issue-gemini
description: Run Gemini CLI planning via the CLI and report the planning results.
allowed-tools: Bash(bunx:*)
---

# Planning workflow

1. Run the following command from the repository root with 1 hour timeout: `bunx @willbooster/agent-skills@latest plan --agent gemini`
2. Report on the issue URL.
Loading
Loading