К основному содержанию
скилл CX Codex официальный · GitHub

scout-issue — скилл для GitHub Copilot: поиск задач

Скилл scout-issue для GitHub Copilot подбирает GitHub issues для вклада в открытые проекты. Он спрашивает об опыте, навыках, времени и типе вклада, затем ранжирует подходящие задачи.

Apache-2.0 ★ 41 430 обновлён 2026-10-23

Установить в GitHub Copilot · GitHub CLI Все способы и платформы ↓
gh skill install github/awesome-copilot skills/scout-issue
Открыть на GitHub

Что делает scout-issue

scout-issue ищет открытые GitHub issues, оценивает их по соответствию навыкам и условиям разработчика, а затем показывает список рекомендаций с баллами и разбором. Запускается по команде /scout-issue или просьбе найти задачу для вклада в открытый проект.

Сначала скилл собирает сведения об опыте, языках программирования, доступном времени, типе вклада и сложности. Затем изучает репозиторий и задачи через GitHub CLI, REST API и git, проверяет описание issue, комментарии, код и тесты. По умолчанию он только читает данные и не меняет issues. Для работы нужны gh и git.

Какие задачи решает

  • найти задачу для первого вклада в открытый проект
  • отобрать issues по языкам программирования и уровню сложности
  • сравнить открытые задачи по объёму и соответствию навыкам
  • выявить задачи с открытым связанным pull request

Примеры запросов агенту

  • Найди в этом репозитории подходящую задачу для первого вклада.
  • /scout-issue rust — подбери задачу на Rust по моему опыту и свободному времени.
  • Найди открытые задачи, которые можно выполнить за выходные.

Как установить scout-issue

1GitHub CLI

gh skill install github/awesome-copilot skills/scout-issue

2Вручную: положить файлы

.github/skills/scout-issue/SKILL.md

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о scout-issue

Как установить scout-issue в GitHub Copilot?

Выполни gh skill install github/awesome-copilot skills/scout-issue. Файл скилла появится по пути .github/skills/scout-issue/SKILL.md.

Что делает scout-issue?

Скилл ищет открытые GitHub issues, оценивает задачи с учётом навыков и условий разработчика и выдаёт ранжированные рекомендации с анализом.

Какие инструменты нужны для scout-issue?

Для поиска и проверки задач используются GitHub CLI (gh) и git.

Исходный текст

SKILL.md · Apache-2.0
---
name: scout-issue
description: "Use when a developer wants to find the best GitHub issues to contribute to in a repository. Invoke with /scout-issue or ask to find good first issues, beginner-friendly issues, or open source work. Asks about experience level, technical skills, time, and contribution type, then searches GitHub issues, scores them, and presents ranked recommendations with match analysis."
---

# Issue Scout - /scout-issue Command

Run this four-phase pipeline when the user invokes `/scout-issue` or asks for
help finding issues to contribute to. This skill is read-only by default:
inspect issues and code, but never modify issues unless the user explicitly
asks.

## Bundled Resources

- `references/interview.md` — intake questions, prioritization, and the internal specification format
- `references/scoring-rubric.md` — scoring dimensions, adaptive weights, and confidence levels
- `references/workflow.md` — end-to-end workflow, decision points, and edge cases
- `references/tool-patterns.md` — GitHub CLI, REST, and git command patterns
- `references/investigation-templates.md` — deep-investigation and implementation-plan output templates
- `references/recovery.md` — cancellation, missing tools, rate limits, and fallbacks
- `references/quick-reference.md` — condensed command and output reference
- `examples/` — worked scenarios, including `copilot-run.md`, a run against real issues
- `scripts/validate-skill.sh` — local consistency check for this skill

Read the relevant reference when a phase needs more detail than this file provides.

## Command Detection

**Trigger:** The user invokes `/scout-issue`, or asks for help finding issues to
contribute to (for example, "find me a beginner-friendly issue I could finish
this weekend").

**Detection:** Parse user input for `/scout-issue` anywhere in the message, or
recognize a request to discover and rank contribution opportunities. If
detected, activate this pipeline instead of normal chat.

**Examples:**
- `/scout-issue`
- `/scout-issue rust`
- `/scout-issue beginner-friendly`
- `Find a beginner-friendly Rust issue I could finish this weekend`

**Note:** If the user types `/scout-issue` again during the process, restart
from Phase 1. If they type `/cancel`, abort the pipeline.

## Pipeline Flow

```
/scout-issue invoked
    ↓
Phase 1: User Interrogation
    ↓
Phase 2: Issue Detection
    ↓
Phase 3: Issue Analysis & Ranking
    ↓
Phase 4: Output Formatting
    ↓
Display to User
```

---

## Phase 1: User Interrogation

**Goal:** Build an internal specification: experience, languages, available
time, contribution type, difficulty, and special requirements.

Ask the six questions in `references/interview.md`, in a single message when the
client supports it. Skip any question the user already answered, and do not
re-ask after a clarification. If the user gives no special requirements, do not
filter on assignment or linked-PR status.

**Output:**
```
Experience: [level]
Languages: [list]
Scope: [time estimate]
Type: [contribution type]
Difficulty: [level]
Special: [requirements]
```

---

## Phase 2: Issue Detection

**Goal:** Find candidate issues with GitHub CLI/REST and git.

### Step 1: Inspect Repository

```bash
repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner)
gh repo view --json name,primaryLanguage,languages
cat CONTRIBUTING.md 2>/dev/null || echo "No CONTRIBUTING.md"
git log --oneline -10
ls -la
```

### Step 2: List Candidate Issues

```bash
# Issue-only total. open_issues_count also counts open pull requests, so it
# overstates the search population.
gh api "search/issues?q=repo:$repo+is:issue+is:open&per_page=1" --jq '.total_count'

# Newest 100 open issues. gh issue list excludes pull requests.
gh issue list --state open --limit 100

# Page beyond 100 with REST. --paginate follows the API's pagination links
# before jq runs, so filtering pull requests cannot cut pagination short. The
# issues endpoint includes pull requests, so drop entries that have a
# pull_request field.
gh api "repos/$repo/issues?state=open&per_page=100" --paginate \
  --jq '.[] | select(.pull_request == null) | .number'

# Filter by label when the user named a language, type, or difficulty hint
gh issue list --state open --label "bug" --limit 50
gh issue list --state open --label "good first issue" --limit 50
```

> **Note:** `gh issue list` and `gh search issues` have no `--page` flag. Use the
> REST issues endpoint with `--paginate` to walk every page, and always filter
> out entries with a non-null `pull_request` field. `gh search issues --repo
> "$repo" --limit N` can raise the search ceiling without pagination; `--repo`
> is required to keep results repository-scoped.

### Step 3: Initial Filtering

Only apply filters that match the user's explicit preferences.

Remove issues that:
- Are assigned, **only** when special requirements include "No active PRs
  (unclaimed work only)".
- Are clearly outside the user's stated skill set.

Keep these for Phase 3 as weighted evidence, not automatic rejection:
- Issues with linked PRs (an **open** linked PR is competing work; closed or
  reverted PRs are evidence only).
- Inactive issues (no activity for 6+ months) unless there is evidence of
  obsolescence or the user set a recency constraint.

**Output:** Candidate issue numbers (typically 20-50).

---

## Phase 3: Issue Analysis & Ranking

> The `good first issue` label is a candidate-hunting hint only. Verify difficulty
> from the issue body, comments, and surrounding code before scoring.

**Goal:** Apply eligibility gates, score candidates, and rank them.

For each candidate:
```bash
gh issue view ISSUE_NUM
gh issue view ISSUE_NUM --comments
gh api "repos/$repo/issues/ISSUE_NUM/timeline" --paginate --jq '[.[] | select(.event == "cross-referenced") | select(.source.issue.pull_request != null) | select(.source.issue.state == "open") | .source.issue.number]'
rg "relevant_function" src/
find . -name "*test*" -type f | head -5
```

**Eligibility gates (all must pass before scoring):**
- The issue is open and still matches the user's hard constraints.
- When the user requested unclaimed work, the issue is unassigned and has no
  open linked PR.
- Evidence comes from the issue body, comments, code, and tests — never from the
  title alone.
- The proposed work is actionable: a location or subsystem can be identified, or
  the missing information is called out as a risk.

**Score each eligible issue 0-100 on:** User Fit, Technical Fit, Scope Fit,
Difficulty Fit, Issue Quality, Activity, Contribution Feasibility, and Evidence
Quality.

Use the default weights (User Fit 20%, Technical Fit 15%, Scope Fit 20%,
Difficulty Fit 15%, Issue Quality 10%, Activity 5%, Contribution Feasibility
10%, Evidence Quality 5%), or the adapted weights in
`references/scoring-rubric.md`. Rank by weighted score and keep the evidence
behind each score.

**Output:** Top 5-10 issues with scores and analysis.

---

## Phase 4: Output Formatting

**Goal:** Present a ranked shortlist that a developer can act on.

**Output contract:** Top 5 maximum. For each issue show the overall match score
out of 100, difficulty level, estimated scope, confidence level, a brief note on
verification gaps, short evidence bullets, and short concerns bullets. End with
a single "best match" recommendation. Use emojis for visual clarity.

Use the template in `references/quick-reference.md` ("Output Format"). Mention
the issue-only candidate pool size and any issues excluded for competing PRs,
assignments, or hard constraints.

**Rules:**
- Show top 5 issues maximum.
- Explain why each issue matches and note concerns.
- Separate evidence from inference; never claim an issue "will definitely be
  accepted" or is "guaranteed to work".
- Never skip eligibility or evidence checks for a quick-scan shortcut.

---

## Investigation Mode

**Trigger:** User says "Investigate #[NUMBER]"

**Action:** Produce the deep-investigation brief in
`references/investigation-templates.md`. Include the problem, why it matches,
relevant code and tests, related PRs/commits, implementation scope, potential
difficulties, maintainer expectations, effort estimate, first steps, and
confidence.

End with: `Want me to create an implementation plan? Say: "Plan this issue".`

---

## Implementation Planning

**Trigger:** User says "Plan this issue" or "How should I approach this?"

**Action:** Produce the implementation plan in
`references/investigation-templates.md`. Separate verified facts from likely
implementation and open questions, and include files to modify, testing
approach, potential challenges, time estimate, and confidence.

End with: `Ready to start? Say: "Start working on this".`

---

## Evidence Rules

- **Evidence:** what was observed — issue text, comment, code, test, timeline, or
  assignment.
- **Inference:** what you conclude — likely actionable, likely accepted.
- Use: likely, appears, suggests, uncertain, insufficient evidence.
- Never: "will definitely be accepted", "guaranteed to work".
- Record the source for every claim; call out gaps instead of filling them.

---

## Error Handling

- **Cancel:** on `/cancel`, stop immediately and return to normal chat.
- **Restart:** on `/scout-issue` again, discard progress and restart Phase 1.
- **Missing tools, auth failures, rate limits:** explain the limitation and use
  the fallbacks in `references/recovery.md`.
- **No issues found:** explain which constraints are binding and offer to relax
  them.

---

## Important Rules

1. Never rank by title match alone.
2. Never trust `good first issue` or `help-wanted` labels without checking the
   issue and surrounding code.
3. Never assume active from open status, or abandoned from age.
4. Always check for open linked PRs before recommending unclaimed work.
5. Always check code and tests when difficulty or feasibility matters.
6. Explain recommendations and rejections.
7. Separate evidence from inference; never invent facts.
8. Fewer, better recommendations beat many weak ones.
9. Read-only by default; never modify issues unless explicitly asked.
10. Handle cancellation and restart at any point.

---

## Portability

Works with any AI CLI that provides shell access, git, and optional GitHub CLI.
If `gh` is unavailable, use the git and web fallbacks in `references/recovery.md`
and state what could not be checked.

© github · Apache-2.0 · github/awesome-copilot

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
agent-1-issue-scout happycapy-ai Субагент agent-1-issue-scout для Claude, который ищет в отобранных GitHub-репозиториях свободные «good first issue» и отдаёт одну выбранную задачу следующему агенту цепочки. CX Codex ★ 138звёзд репо gh-issue-sync mitsuhiko Синхронизирует GitHub Issues с локальными Markdown-файлами. Агент работает с задачами прямо в репозитории — создаёт, редактирует, закрывает и пушит изменения через gh-issue-sync push. CX Codex +1 28 500установок oss-issue-triage Samuel Berthe Скилл oss-issue-triage проектирует систему разбора issues и пул-реквестов под реальные силы команды мейнтейнеров: метки, приём заявок, сроки ответа, дежурства. CX Codex +1 13 400установок om-followup-issue-from-pr open-mercato Скилл om-followup-issue-from-pr для Claude Code превращает ссылку на PR или комментарий из ревью в задачу трекера. Фиксирует правки после ревью как issue. CX Codex +1 3 700установок resolve-issue sentimony Скилл resolve-issue для Claude Code и Codex ведёт задачу из GitHub через весь цикл разработки от анализа до приёмки. Запускается по номеру или ссылке на задачу для пошагового контроля или в режиме --auto. CX Codex +1 1 200установок issue-tracker clhbid Скилл issue-tracker для Claude Code задаёт термины и правила работы с GitHub issues. Он включается при операциях с задачами и доской в репозиториях clhbid. CX Codex +1 795установок

Из того же набора993

Весь набор →
spring-security Помогает настраивать, тестировать и проверять Spring Security. Подключается при добавлении или аудите аутентификации и авторизации в приложении Spring Boot. CX Codex +1 ★ 41 430звёзд репо spring-observability Скилл spring-observability для GitHub Copilot настраивает наблюдаемость в сервисах на Spring Boot 3 и 4. Включается при добавлении метрик Micrometer, трассировки OpenTelemetry и структурированных логов с Actuator. CX Codex +1 ★ 41 430звёзд репо spring-boot-4-migration Скилл spring-boot-4-migration для GitHub Copilot переносит приложение со Spring Boot 3.x на 4.0. Запускается для миграции, разбора вызванных ею ошибок сборки и тестов или проверки уже выполненного перехода. CX Codex +1 ★ 41 430звёзд репо skill-distribution-audit Скилл skill-distribution-audit для GitHub Copilot проверяет репозитории со скиллами перед релизом. Сверяет исходные файлы с манифестом дистрибуции и реальной поисковой выдачей клиента. CX Codex +1 ★ 41 430звёзд репо sap-cloud-integration Помогает писать и разбирать iFlow в SAP Cloud Integration. Срабатывает при работе с CPI-скриптами Groovy, настройками обмена и ошибками адаптеров. CX Codex +1 ★ 41 430звёзд репо pr-artifact-explorer Скилл pr-artifact-explorer для GitHub Copilot открывает GitHub PR, issues, запуски workflow, Actions-артефакты и веб-превью в общей панели. Он включается по запросу показать или изучить эти материалы. CX Codex +1 ★ 41 430звёзд репо ponder Скилл ponder для GitHub Copilot запускает цикл повторных проходов оценки проекта, пока выводы модели не перестанут меняться. Проверяет полное покрытие всех модулей без пропуска файлов. CX Codex +1 ★ 41 430звёзд репо openapi-to-application-java-spring-boot Скилл openapi-to-application-java-spring-boot для GitHub Copilot превращает спецификацию OpenAPI в основу приложения на Spring Boot. Он включается, когда нужно создать или доработать Java API по файлу OpenAPI или Swagger. CX Codex +1 ★ 41 430звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой