Share Config

---
name: share-config
description: "Promote local config to a shared team config that can be committed to git."
category: ai-agents-and-harness
source_repo: hashgraph-online/awesome-codex-plugins
source_path: "plugins/yimwoo/codex-agenteam/skills/share-config/SKILL.md"
source_url: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/yimwoo/codex-agenteam/skills/share-config/SKILL.md
---


# AgenTeam Share Config

Create a shared team config from your local config so collaborators
can use the same pipeline, roles, and settings.

## Process

### 1. Check Prerequisites

Verify `.agenteam/config.yaml` (or legacy `agenteam.yaml`) exists.
If not, tell the user: "No local config found. Run `@ATeam init` first."

### 2. Check for Existing Team Config

If `.agenteam.team/config.yaml` already exists:
- Tell the user: "Team config already exists at `.agenteam.team/config.yaml`.
  Edit it directly to change team settings."
- Stop. Do not overwrite.

### 3. Load and Strip Personal Fields

Load the current config. Strip ALL personal-allowlist fields from
every role:

- `model` (personal preference)
- `reasoning_effort` (personal preference)
- `system_instructions` (may contain personal addenda)
- `nickname_candidates` (personal display preference)
- `mcp_servers` (local/private tool wiring)
- `skills_config` (local/private skill wiring)

These fields are stripped because they should not become team policy.
The user can review and re-add team-relevant instructions manually.
Stripping `model` intentionally restores platform default inheritance for
collaborators and avoids sharing a pin that may be unavailable in their Codex
catalog.

### 4. Normalize Version

If `version` is not `"2"`, set it to `"2"`.

### 5. Write Team Config

```bash
mkdir -p .agenteam.team
```

Write the stripped config to `.agenteam.team/config.yaml`.

### 6. Summary

Print:

```
Team config created at .agenteam.team/config.yaml

What was stripped (personal-only fields):
  - roles.*.model
  - roles.*.reasoning_effort
  - roles.*.system_instructions
  - roles.*.nickname_candidates
  - roles.*.mcp_servers
  - roles.*.skills_config

Review it before committing. To customize:
  - Team settings: edit .agenteam.team/config.yaml (tracked in git)
  - Personal overrides: create .agenteam/config.yaml (gitignored)

Next steps:
  git add .agenteam.team/
  git commit -m "Add shared AgenTeam team config"
```

## Notes

- The team config becomes the source of truth for pipeline, stages,
  gates, roles, and isolation.
- Personal overrides in `.agenteam/config.yaml` can only change
  `model`, `reasoning_effort`, `system_instructions` (append),
  `nickname_candidates`, `mcp_servers`, and `skills_config`.
- The team can widen personal overrides with `allow_personal_override`
  in the team config.

---

**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/yimwoo/codex-agenteam/skills/share-config/SKILL.md`