Skip to content

docs(skills): use jq when Gmail tool results come back as a file reference - #147

Merged
josegironn merged 1 commit into
mainfrom
docs/gmail-skill-jq-file-reference
Jul 31, 2026
Merged

docs(skills): use jq when Gmail tool results come back as a file reference#147
josegironn merged 1 commit into
mainfrom
docs/gmail-skill-jq-file-reference

Conversation

@josegironn

@josegironn josegironn commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Any Gmail MCP tool result (gmail_get_message included, not just gmail_invoke) can exceed the size limit and get written to disk as a file reference instead of inline JSON.
  • Adds one tool-agnostic instruction: don't Read the file into context, use jq to extract only what's needed, with example one-liners for headers, a plain-text body part, and message IDs.
  • Cross-referenced from the Tips list.

Test plan

  • Docs-only change; reviewed rendered SKILL.md for accuracy and placement.

🤖 Generated with Claude Code

https://claude.ai/code/session_017NpZTz619At32Xqh26gmDM

Made with Orca 🐋

…rence

Any Gmail MCP tool result can be too large to inline and get written to
disk instead. Document a single tool-agnostic instruction: don't Read
the file into context, use jq to pull out only what's needed.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017NpZTz619At32Xqh26gmDM

Co-authored-by: Orca <help@stably.ai>
@josegironn
josegironn merged commit 26148ca into main Jul 31, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant