#15803: fix(skills/github): add GraphQL introspection guidance
stale
size: XS
Cluster:
Skill Documentation and Enhancements
## Summary
The github skill only documents REST usage for `gh api`. When the agent needs
GraphQL (e.g. GitHub Projects V2 mutations), it hallucinates incorrect mutation
names, gets `undefinedField` errors, and tells the user to "use the GitHub UI."
This adds:
- `gh api graphql` examples (query + mutation)
- Schema introspection commands to discover correct mutation/field names
- Guidance to introspect on `undefinedField` errors instead of guessing
## Testing
- Tested on a live OpenClaw instance (MiniMax-M2.1 via Telegram)
- Before: agent hallucinated `updateProjectV2SingleSelectField` (does not exist)
- After: agent used correct `updateProjectV2Field` with proper input fields
## AI Disclosure
- [x] AI-assisted (Claude)
- [x] Tested on live instance
- [x] I understand what the change does
Fixes #15796
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
Updates the GitHub skill documentation to cover `gh api` GraphQL usage in addition to REST, including an example query and schema introspection snippets to avoid guessing mutation/field names when working with GitHub Projects V2.
<h3>Confidence Score: 4/5</h3>
- This PR is largely safe to merge, with one documentation correctness issue to fix.
- Change is doc-only and guidance is generally sound, but the added GraphQL examples omit `--repo` despite the skill’s own requirement to include it outside a git directory, which can cause the documented commands to fail for users.
- skills/github/SKILL.md
<sub>Last reviewed commit: 2f26c92</sub>
<!-- greptile_other_comments_section -->
<sub>(3/5) Reply to the agent's comments like "Can you suggest a fix for this @greptileai?" or ask follow-up questions!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#15860: docs(github): add GraphQL API guidance and schema introspection
by Shuai-DaiDai · 2026-02-14
90.2%
#3642: Add repository metadata field for skill transparency
by ADITYABHURAN · 2026-01-28
77.0%
#7656: docs(slack): improve skill documentation with thread support and AP...
by pswpswpsw · 2026-02-03
76.7%
#5273: fix: skill frontmatter fixes + description improvements (35 skills)
by Terwox · 2026-01-31
76.1%
#19658: feat(skills): add overlap-check — search before filing issues or PRs
by SeMmyT · 2026-02-18
76.0%
#8873: fix: document skill loading locations in system prompt
by ytfh44 · 2026-02-04
75.9%
#19664: fix(skills): log skill YAML parsing diagnostics with skill name
by orchidsun · 2026-02-18
75.5%
#17684: fix(skills): update notion skill for API 2025-09-03
by chug2k · 2026-02-16
75.2%
#13594: fix(skills): correct apple-notes SKILL.md memo -a syntax
by lailoo · 2026-02-10
75.1%
#19579: fix(skills): complete clawhub SKILL.md with missing commands
by buddyh · 2026-02-18
74.8%