{
  "markdown": "# Masthead Agent Plugins & Skills\n\nA unified, multiplatform agent toolkit for [Masthead Data](https://mastheadata.com) — BigQuery data observability and FinOps cost optimization for Google Cloud.\n\nThis repository provides single-source-of-truth plugins and skills for:\n\n- **Claude Code**\n- **OpenAI Codex**\n- **Antigravity / Gemini CLI**\n- **Universal Skills CLI**\n\n---\n\n## Core Capabilities\n\n1. **FinOps (Cost Savings)**: Optimize BigQuery compute, storage, data models, and pipelines based on historical dataset insights.\n2. **Real-Time Observability**: Connect via Model Context Protocol (MCP) to investigate, trace lineage, and resolve live pipeline failures and data anomalies.\n\n### Safety Framework: Cautious Advisory (Non-Action)\n\nAll FinOps skills adhere to strict non-action principles:\n\n- **Zero Automated Mutations**: The agent **never** executes destructive commands (`bq rm`), alters billing configurations (`bq update`), or disables running pipelines directly.\n- **Decision Support & Artifacts**: The agent investigates recency, analyzes lineage and downstream impact, provides clear cost/risk trade-offs, and generates whatever review artifacts the human operator requests (Markdown review tables, CSV candidate exports, or standalone shell scripts with dry-run commands for the user to inspect and run).\n\n---\n\n## Slash Commands\n\nWhen installed in Claude Code or Antigravity, quick slash commands are available:\n\n- `/triage` — Launch real-time incident triaging, upstream lineage inspection, and blast-radius analysis across monitored GCP projects.\n- `/savings` — Audit BigQuery storage and compute waste across tables, datasets, data models, and pipelines.\n\n---\n\n## Installation\n\n### 1. Claude Code\n\nAdd the Masthead marketplace and install the plugin:\n\n```text\n/plugin marketplace add masthead-data/for-agents\n/plugin install masthead-agent-tools@masthead-data\n/reload-plugins\n```\n\nFor local development from a cloned repository:\n\n```bash\nclaude plugin marketplace add ./\nclaude plugin install masthead-agent-tools@masthead-data\n```\n\n### 2. OpenAI Codex CLI\n\nAdd the marketplace and install via Codex CLI:\n\n```bash\ncodex plugin marketplace add masthead-data/for-agents\ncodex plugin add masthead-agent-tools@masthead-data\n```\n\nOr interactively inside Codex via `/plugins`.\n\n### 3. Google Antigravity & Agent Plugins (1.0.0)\n\nThis repository adheres to the vendor-neutral [Agent Plugins 1.0.0](https://agent-plugins.org) specification.\n\nTo add this plugin to Antigravity:\n\n- **Workspace Level**: Clone into your project's `.agents/plugins/`:\n\n  ```bash\n  git clone https://github.com/masthead-data/for-agents.git .agents/plugins/masthead-agent-tools\n  ```\n\n- **Global Level**: Make it available across all workspaces by placing it in `~/.gemini/config/plugins/`:\n\n  ```bash\n  git clone https://github.com/masthead-data/for-agents.git ~/.gemini/config/plugins/masthead-agent-tools\n  ```\n\n### 4. Universal Skills CLI\n\nInstall individual skills or the full suite directly into any project:\n\n```bash\n# Install all skills\nnpx skills add masthead-data/for-agents\n\n# Or install a specific skill\nnpx skills add masthead-data/for-agents --skill masthead-storage-savings-with-tables\n```\n\n---\n\n## Prerequisites & Authentication\n\n- **Masthead Account & Dataset**: A provisioned Masthead insights dataset in BigQuery. [Request access →](https://docs.mastheadata.com/api#get-access-to-bigquery-resources)\n- **Google Cloud CLI**: Authenticated via `gcloud auth login` with BigQuery read permissions.\n- **MCP Server Authentication**: The Masthead MCP server at `https://mcp.mastheadata.com/mcp` authenticates via native Google OAuth 2.0 popup in your agent client (service account support coming soon).\n\nWhen a FinOps skill runs for the first time, it prompts for your insights dataset ID (e.g. `masthead-prod.client_xyz_insights`) and caches it into your global (`~/.masthead/config.json`) or project config (`.masthead/config.json`).\n\n---\n\n## Available Skills\n\n| Skill | Category | Mode | Description |\n| --- | --- | --- | --- |\n| [`masthead-incident-triaging`](skills/masthead-incident-triaging/) | Observability | MCP | Triage, trace upstream/downstream lineage, assign ownership, and manage live incidents. |\n| [`masthead-storage-savings-with-tables`](skills/masthead-storage-savings-with-tables/) | FinOps | Local SQL | Identify and clean up dead-end and unused BigQuery tables. |\n| [`masthead-storage-savings-with-datasets`](skills/masthead-storage-savings-with-datasets/) | FinOps | Local SQL | Optimize dataset-level billing models (logical vs. physical) and partition expiration. |\n| [`masthead-compute-savings-with-data-models`](skills/masthead-compute-savings-with-data-models/) | FinOps | Local SQL | Rebalance Dataform, dbt, and Airflow model compute between reservations and on-demand. |\n| [`masthead-compute-savings-with-pipelines`](skills/masthead-compute-savings-with-pipelines/) | FinOps | Local SQL | Detect and pause legacy, orphaned, or inefficient data pipelines. |\n\n---\n\n## Resources\n\n- [Masthead Documentation](https://docs.mastheadata.com)\n- [MCP Integration Guide](https://docs.mastheadata.com/developer/mcp/)\n- [Contributing Guidelines](CONTRIBUTING.md)\n",
  "bytes": 5181,
  "sha": "10da252de82f9697ca635fe1cb9f3e66e1123cef5ed229ee3f031cb968a7367f",
  "repo_slug": "masthead-data/for-agents",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_masthead_data_for_agents_masthead_data_8a4e6daa/readme"
}