external-references v1.0.0A

Immutable. This exact content never changes and is served at /api/v1/blob/7916cc10ce4b1b25.

---
name: external-references
license: MIT
metadata:
  version: "1.0.0"
description: |
  USE FOR: Reference-only external provider packs and dormant source
  inventory — dbt, Azure/Microsoft Foundry, Databricks, Google Cloud/GCP, AWS,
  Terraform/HashiCorp, Google Workspace, Streamlit — plus provider-pack
  lookup and promotion questions. DO NOT USE FOR: repo-local guardrails,
  harness implementation, or making provider packs active without explicit
  promotion.
---

# External References

Route external provider-pack requests to dormant references without activating
the broad packs by default. The generated reference tree is
`~/.local/share/skills`.

## 1. Workflow

1. Inspect `nix/home-manager/agents/shared/agent-skills.nix`.
2. Inspect matching skill bodies under `~/.local/share/skills/<skill-name>`.
3. Use `referenceOnlySources` as the dormant provider-pack inventory when the
   generated tree is missing or needs source-level verification.
4. Prefer local owner skills for guardrails: `data-platform`, `programming`,
   or `dotfiles`.
5. For provider syntax not covered locally, inspect the pinned source or
   upstream docs without adding it to loader paths.
6. Promote only on an explicit active-provider-pack request.

## 2. Dormant Packs

- `databricks-official`: Databricks.
- `dbt`: dbt, dbt Labs.
- `azure`: Azure, Microsoft Foundry, Entra.
- `google`: Google Cloud, GCP, BigQuery, GKE, AlloyDB.
- `aws`: AWS, Amazon Web Services.
- `hashicorp-terraform`: Terraform, HashiCorp.
- `googleworkspace-cli`: Google Workspace CLI skills (Gmail, Calendar, Docs,
  Sheets, and more), plus persona and recipe templates.
- `streamlit`: Streamlit apps.

## 3. Promotion Rules

For Claude, add a source through `i9wa4.agentSkills.extraSources` or make an
explicit repo decision to move it active. For Codex, also update both
`codexMinimalSourceNames` and `codexMinimalAllowlist`.