external-references · diff
v1.0.0 to v1.0.0
8 added, 2 removed. Audit A to A.
---
name: external-references
license: MIT
metadata:
version: "1.0.0"
description: |
- USE FOR: Reference-only external provider packs and dormant source inventory: dbt, azure, databricks-official, obsidian, hashicorp-terraform, google, aws, streamlit, Databricks, Azure, Microsoft Foundry, Google Cloud, GCP, AWS, Terraform, HashiCorp, Obsidian, Streamlit, provider-pack lookup, and promotion questions. DO NOT USE FOR: repo-local guardrails, harness implementation, or making provider packs active without explicit promotion.
+ 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.
- - `obsidian`: Obsidian, Bases, Canvas, Markdown vault workflows.
+ - `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`.