aspiers/ai-config / .agents/skills/checking-upstream
checking-upstream
VerifiedChecks the canonical upstream issue tracker, discussion forums, and open pull requests, merge requests, or equivalent change queues for existing reports, discussion, or work on a problem just discussed. Use before diagnosing, fixing, or reporting an apparent open-source problem to avoid duplicate effort and missed context.
Checking Upstream
Find existing upstream knowledge or work before taking action.
-
Infer the project and precise problem from the conversation and any command arguments. Ask one focused question only if either is unclear.
-
Identify the canonical upstream repository and tracker, not just a fork or package mirror.
-
Search the issue tracker, including closed issues, and the open pull request, merge request, patch, or equivalent change queue. Try a few focused variants: the exact error or symbol, the symptom, and the affected component.
-
Search the project's discussion venues too. Issues and change queues are never the whole record: feature requests, design debates, and "is this intended?" questions frequently live only in a forum, and a maintainer's answer there may be the sole statement of intent. Check every venue the project actually uses, for example:
- GitHub Discussions, GitLab issue boards used as forums, or a Discourse instance;
- a mailing list, Matrix/IRC/Discord/Slack archive, or wiki;
- a
DISCUSSIONS.md,SUPPORT.md, or README section naming where questions belong.
Confirm which venues exist rather than assuming. On GitHub, Discussions are separate from issues and are missed by an issue-only search, so query them explicitly:
gh api graphql -f query=' { repository(owner: "OWNER", name: "REPO") { discussions(first: 1) { totalCount } discussionCategories(first: 20) { nodes { name } } } }'When the total is small (a few hundred or fewer), fetch title and body for all of them and filter locally — that is exhaustive and avoids missing a thread whose title never uses your search terms. Otherwise use
gh searchor the venue's own search with the same focused variants. -
Find the project's stance on AI-generated contributions. Check
CONTRIBUTING*,CODE_OF_CONDUCT*, anyAI_POLICY*or similar file, issue and pull-request templates, and the org-level.githubrepository. Then search issues, pull requests, their comments, and the discussion venues for terms such as AI, LLM, Copilot, ChatGPT, Claude and "generated". Maintainers often state the policy only in a comment on an unrelated thread, so a check of policy files alone is not enough. -
Read plausible matches enough to verify relevance. Note their status, latest meaningful activity, linked work, decisions, workarounds, and blockers.
-
Report concisely:
- canonical upstream and tracker URLs;
- which venues were searched, and which exist but were not searched;
- any AI-contribution policy or maintainer statement, quoted with its URL, date and the thread it appeared in, or that none was found;
- relevant matches with title, status, URL, and why they match;
- an assessment: active work, discussion only, previously resolved, or no relevant match;
- any useful conclusions, workarounds, or missing information.
Prefer tracker-native search or APIs, with web search as a fallback. If no matches are found, state the searches performed and the venues covered, and note that this does not prove no report exists. Never report "not tracked upstream" on the strength of an issue-only search; say which venues that conclusion rests on.
Do not modify code, file or comment on an issue, or open a change request unless explicitly asked.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |