#15860: docs(github): add GraphQL API guidance and schema introspection
docs
agents
stale
size: S
Cluster:
Skill Documentation and Enhancements
## Problem
The GitHub skill only documents REST API usage, causing agents to hallucinate incorrect GraphQL mutation names.
## Solution
Added GraphQL documentation including schema introspection and troubleshooting.
Fixes #15796
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
This PR expands the GitHub skill documentation to cover GraphQL usage (including schema introspection and error troubleshooting) so agents can discover correct mutation/field names instead of guessing. It also tweaks the compaction docs configuration section and updates the Moonshot provider’s default model ID (plus adds several additional Moonshot model definitions) to match the expected API model naming.
Overall, the changes are additive and aligned with existing patterns (skill docs under `skills/github/`, provider defaults under `src/agents/models-config.providers.ts`). The main follow-ups are around keeping docs navigable (don’t remove the only link to compaction config) and ensuring the new GraphQL CLI examples are copy/paste reliable.
<h3>Confidence Score: 4/5</h3>
- This PR is generally safe to merge; remaining concerns are limited to documentation accuracy/usability.
- Changes are mostly documentation plus a small provider default update. No clear runtime-breaking logic was introduced, but a docs self-reference was removed and one GraphQL example is brittle to copy/paste, which could mislead users/agents.
- docs/concepts/compaction.md, skills/github/SKILL.md
<sub>Last reviewed commit: 2d5eb50</sub>
<!-- greptile_other_comments_section -->
<sub>(5/5) You can turn off certain types of comments like style [here](https://app.greptile.com/review/github)!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#15803: fix(skills/github): add GraphQL introspection guidance
by rixau · 2026-02-13
90.2%
#7656: docs(slack): improve skill documentation with thread support and AP...
by pswpswpsw · 2026-02-03
76.7%
#16087: docs: enhance OpenCode documentation in coding-agent skill
by imwxc · 2026-02-14
73.2%
#17684: fix(skills): update notion skill for API 2025-09-03
by chug2k · 2026-02-16
73.1%
#15115: fix: pre-load skill docs in cron sessions to prevent hallucinated syn…
by joaolcorreia · 2026-02-13
72.5%
#7252: docs: align config examples and tool docs with current runtime
by nice-and-precise · 2026-02-02
72.5%
#5273: fix: skill frontmatter fixes + description improvements (35 skills)
by Terwox · 2026-01-31
72.5%
#3642: Add repository metadata field for skill transparency
by ADITYABHURAN · 2026-01-28
72.5%
#19307: docs: add Google (Gemini) provider documentation
by manueltarouca · 2026-02-17
72.0%
#13594: fix(skills): correct apple-notes SKILL.md memo -a syntax
by lailoo · 2026-02-10
71.8%