smith-gh-cli
GitHub CLI gotchas and best practices. Use when executing gh commands. Covers token efficiency, pagination limits, and common pitfalls.
📖 中文导读:GitHub CLI gotchas and best practices. Use when executing gh commands. Covers token efficiency, pagination limits, and common pitfalls. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: smith-gh-cli description: GitHub CLI gotchas and best practices. Use when executing gh commands. Covers token efficiency, pagination limits, and common pitfalls.
GitHub CLI Best Practices
- Load if: Using GitHub CLI commands
- Prerequisites:
@smith-git/SKILL.md,@smith-gh-pr/SKILL.md
CRITICAL: Avoid GitHub MCP (Primacy Zone)
- GitHub MCP tools - hard to control pagination (25k token truncation), less complete than CLI, requires personal token
Use instead: gh pr-review extension, gh api, or GraphQL queries
Token Efficiency
Safe perPage limits:
list_pull_requests: perPage 20-30get_review_comments: perPage 10 (bot reviews are massive)get_files: perPage 30search_repositories: minimal_output: true
Common Pitfalls
- ALWAYS assign yourself:
--assignee @me - Draft PRs: Use
--draftwith#WIPin title for work-in-progress - Ensure gh installed: If
ghnot found, prompt user/agent to install
Issue Linking
In PR descriptions:
Closes #123- Auto-closes on mergeFixes #123- Same as ClosesRelates to #123- Links without closing
@smith-gh-pr/SKILL.md- PR workflows, review comment fetching@smith-git/SKILL.md- Git operations