XActions GEMINI.md

Repository instructions for XActions, a project that provides command-line and service-based access to social-media data, with specific guidance for Gemini.

In plain words
What is it for?
Running commands to retrieve profiles or posts, choosing compact or JSON output, and locating the project documentation and skill instructions needed for Gemini-related work.
Why use it?
They direct the agent to the main project instructions and show when to use the command line or service interface, reducing the risk of following outdated or incomplete guidance.

Instructions file for Gemini CLI

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/nirholas/xactions/gemini-md
Clone the repo
git clone --depth 1 https://github.com/nirholas/XActions

Made for: Gemini CLI.

Per session 403 This file is loaded in full into every session.
When invoked 403 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00403 $0.00403
Opus 5 $0.00201 $0.00201
Sonnet 5 $0.00081 $0.00081
Haiku 4.5 $0.00040 $0.00040

Measured 2d ago against content hash 887db71c9ee8, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

XActions GEMINI.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

GEMINI.md · 37 lines

What it actually says

XActions: instructions for Gemini

Read AGENTS.md. It is the single source of truth for how to work in this repository, and it is kept current. This file adds only what is specific to Gemini; it deliberately does not restate AGENTS.md, because the last time four files described the repository they drifted apart and an agent worked a whole session from the stale one.

AGENTS.md answers, in this order: which lane to use (shell out to the xactions CLI, or load the MCP server), the CLI lane and its output contract, the MCP lane, a table from common request to the exact file that answers it, the skills, the directory map and the three runtime contexts, and the mistakes that have actually cost people time here.

Gemini specifics

The CLI lane is usually the right one here: one shell call, no tool list to load.

npx xactions profile nasa --compact     # no account, no browser
npx xactions tweets nasa --limit 50 --json

--compact prints one record per line as tab-separated key=value pairs; --fields narrows that to the columns you name; --json prints the full object. --compact wins if both are passed.

The skills are plain Markdown and readable directly from skills/. The installer writes them into a specific host's directory, and its targets today are claude, project, cursor, codex and windsurf:

xactions skills list                            # every skill and what it covers
xactions skills show follower-monitoring        # read one without installing it
xactions skills install --all --target project  # ./.claude/skills/ in this repo

Everything else is in AGENTS.md.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 37 lines · 403 tokens per session scan A 887db71c9ee8

Subscribe to this mod's changes

XActions GEMINI.md is an instructions file published in the GitHub repository nirholas/XActions (496 stars, last pushed 5d ago), licensed Apache-2.0. It adds 403 tokens to every session, about $0.0020 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

generative-ai-for-beginners AGENTS.md

Instructions for microsoft/generative-ai-for-beginners, covering agents.md, project overview, setup commands, initial repository setup and clone the repository.

microsoft/generative-ai-for-beginners · 2,850 tokens

langroid CLAUDE.md

Claude Code instructions for langroid/langroid, covering claude.md, commands, development, testing and linting and type checking.

langroid/langroid · 2,637 tokens

E2B CLAUDE.md

Claude Code instructions for e2b-dev/E2B: Use pnpm for node and uv for python to install and update dependencies. Run pnpm run format, pnpm run lint and pnpm run typecheck before committing changes. When modifying the SDK packages, ensure equivalent changes are applied to both JS as well as sync and async Python…

e2b-dev/E2B · 306 tokens

arxiv-mcp-server CLAUDE.md

Instructions for blazickjp/arxiv-mcp-server, covering claude.md, project, setup and validation, architecture and tool groups.

blazickjp/arxiv-mcp-server · 831 tokens

helicone AGENTS.md

AGENTS.md instructions for Helicone/helicone, covering repository guidelines, project structure & module organization, build, test, and development commands, coding style & naming conventions and testing guidelines.

Helicone/helicone · 791 tokens

langwatch CLAUDE.md

Claude Code instructions for langwatch/langwatch, covering langwatch, before you implement anything, development environment, running with no container runtime and local dev by hostname — thuishaven / portless (recommended).

langwatch/langwatch · 10,001 tokens