Add finding-contribution-opportunities skill - #8
Draft
mattobee wants to merge 1 commit into
Draft
Conversation
Generalised from a personal profile-raising workflow into a reusable skill: finds GitHub and Slack conversations where the user's expertise adds value (engage) and surfaces their own in-flight work worth sharing (amplify), ranks them, and drafts wording in the user's voice. Read-only; never posts. User identity, areas of expertise, orgs/repos, and an optional notes source are configurable inputs.
There was a problem hiding this comment.
Pull request overview
Adds a new Agent Skills specification document for finding-contribution-opportunities, aimed at helping users identify (and draft) high-value “engage” and “amplify” opportunities across GitHub/Slack, while explicitly remaining read-only.
Changes:
- Introduces the
finding-contribution-opportunitiesskill with detailed workflow steps, ranking guidance, and drafting guidelines. - Documents GitHub/Slack hunting strategies (mentions-first), plus optional notes mining for “amplify”.
- Adds the new skill to the README with install instructions and example prompts.
Show a summary per file
| File | Description |
|---|---|
| skills/finding-contribution-opportunities/SKILL.md | Defines the new read-only skill behavior, sources, ranking, and suggested-drafting approach. |
| README.md | Adds installation snippet and example prompts for the new skill. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 2/2 changed files
- Comments generated: 6
Comment on lines
+136
to
+138
| Search the user's relevant orgs and repos. Use the `gh` CLI and `gh search`, running several | ||
| focused searches rather than one broad one. Substitute `<handle>`, the date window, and the | ||
| user's topic keywords. |
Comment on lines
+186
to
+187
| Use a public Slack search tool (no consent needed for public channels). Run several targeted | ||
| searches over the window. |
Comment on lines
+145
to
+149
| --updated=">=$(date -v-14d +%Y-%m-%d)" -L 40 \ | ||
| --json title,url,updatedAt,repository,number,commentsCount | ||
| gh search prs 'mentions:<handle>' --state=open \ | ||
| --updated=">=$(date -v-14d +%Y-%m-%d)" -L 40 \ | ||
| --json title,url,updatedAt,repository,number |
Comment on lines
+165
to
+170
| --updated=">=$(date -v-14d +%Y-%m-%d)" -L 40 \ | ||
| --json title,url,updatedAt,repository,number,commentsCount,labels | ||
| gh search prs --owner=<org> --state=open \ | ||
| '<keyword> OR <keyword>' \ | ||
| --updated=">=$(date -v-14d +%Y-%m-%d)" -L 30 \ | ||
| --json title,url,updatedAt,repository,number |
| --json title,url,updatedAt,repository,number | ||
| ``` | ||
|
|
||
| Note: `date -v-14d` is macOS (BSD) syntax. On Linux use `date -d '14 days ago' +%Y-%m-%d`. |
|
|
||
| ```bash | ||
| gh search prs --author=<handle> --state=open \ | ||
| --updated=">=$(date -v-7d +%Y-%m-%d)" -L 40 \ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a
finding-contribution-opportunitiesskill that helps the user find good places to contribute and be more visible, then drafts wording they can post themselves. It's strictly read-only so it never posts anything.It works in two modes:
It searches, ranks everything against relevance/visibility/value/freshness, and drafts suggested wording in the user's voice for them to review and send.
How it works
gh(mentions first, then topic searches), Slack via a public search tool, and optionally the notes source.